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PREFACE 





This manual provides console operating instructions for the Intellec Series 108) 
an, Microcomputer Development System, an advanced system that provides dual 
Pe operating environments, one for 8086/8088-based software and another >for 

ie 8080/8085-based softwares: ay - 
This manual is ; designed to Sask new users as well as those who are already 
familiar with abade a deat 


ye 


Operation of this system requires version 4.1 or later of the ISIS-II operating 
system. Wherever 8086-based software is ref erenced i in this manual, the information 
applies equally to 8088-based software. 


This manual contains seven ‘chapters and seven appendixes: 


ae Chapter 1, ‘System Overview, describes the keyboard, control panel, screen, ook 
drives, and configurations supported. 


ae Chapter 2, System Operation, describes system start-up and ghaedoaat and 
disk formatting tutorials. me 


® Chapter 3,° ‘Device/File Management, describes device/file naming eine 
device/ file accessing, and disk directories. 


o Chapter 4, Console Commands, describes and shows examples of the ISIS-I] 
commands for storing, identifying, and manipulating your programs. 


® Chapter: 5; The Monitor, describes and shows examples of the Monitor 
- commands for 8080/8085. program debugging. 


eg Chapter 6, ‘DEBUG-86, describes and shows examples of the DEBUG- 86 
. . commands for 8086 program debugging. 


_ Chapter 7, Error Messages, gives a listing of error messages and recovery. 













decimal: Decimal Conversions, provides 


Appendix: -B Hexa 
ay aad siecimal-to-hexadecinal conversions. 


Ree: 







Appendix D, Summaryof ISIS-1] Console Commands, provides a listing of all 
ISIS-I console commands and ania syntax. 








S commands and their syntax. 


DEBUG-86 commands; and their syntax. ae 


The Intellec Series II] Microcomputer. Development System is part of the 
eo 80 iAPX family et 





os 
2 
“« 
= 
- 
» foe 
oe 
eo: 
ee 
o 


- Microsystem 80 ) Nomenclature : 





Over the last several years, the increase in microcomputer system and software —_ 
plexity has given birth to a new family of microprocessor products oriented towards 
solving these increasingly kee prekicms: This new generation of 


Appendix E- Summary ‘of DEBUG- 36 “commands, provides a listing of all 


Appendix G, Summary. ‘of Error M lessages, provides a listing of error messages. 


iii 
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microprocessors is both powerful and flexible and includes many processor 
enhancements, such as numeric floating point extensions, 1/O processors, and 
operating system functionality i in silicon. 


As Intel’s product line has grown and evolved, its microprocessor product number- 
ing system has become adequate to name VLSI solutions involving the above 
enhancements. ks 


In order to Pee ee ine new VLSI systems, we've allowed the 8086 faraily 
name to evolve into a more comprehensive numbering scheme, while still including 
the basis of the previous 8086 nomenclature. . 


We've adopted the following prefixes to provide differentiation and consistency 
among our Microsystem 80 related product lines: 


iAPX — Processor Series 

iRMX — Operating Systems 

iSBC — Single Board Computers 
iSBX. _ -MULTIMODULE Boards 


. Concentrating on the jAPX. Series, two Precesor Families are defined: 


iAPX 86 — - 8086 CPU based system 
_ iAPX 38 _ “8088 CPU based system 


With additional suffix information, configuration options within each iAPX system 
can be identified, for brea Hs 


iAPX 86/ 10° “CPU alone (8086) 
. jAPX 86/11.. CPU + LOP.(8086 + 8089) 
iAPX 88/20 CPU + Math Extension (8088 + 8087) 
iAPX 88/21. CRU + Math: Ean + 1OP (8088 + 8087 + 8089) 





This Be encene. is ; intended as. an ‘addition to rather than a replacement for, 


Intel’s current part numbers. These new series level descriptions are used to describe 
the functional capabilities ‘provided by specific configurations of the processors in 


the 8086 Family..The hardware used to implement each functional configuration is 
still described by referring to the parts involved (as is the case for the majority of the 
ee an information described i thi 





This improved nomenclature Srovides. a more re uicesliaidl view of system capability 
i lving Mtesy tem 80 architecture. 


For 4 more information: on. the Intellec Series 884 F siceocerpuies Development 
System, see the following manuals: ae 


® Intellec TIL ‘Microcomputer Development System Product OverViEN, 





o Intellec Series. HI Microcomputer Development System pionrammens 
Reference Manual, 121618 = 


e@ Intellec Series “III ‘Microcomputer Development System Installation and 


Checkout Manual, 121612 

© Intellec Series ah Microcomputer Development Svstem Schematic Draws, 
121642. 

® jiAPX 86, 88 Family ‘Utilities User’s Guide for 8086-Based Davelosment 
Systems, 121616 — oe : 


© $§1§-1] CREDIT CRT-Based Text Editor User's Guide, 9800902 

@ The 8086 Family User's Manual, 9800722 

© §8086/8087/8088 Macro Assembly Language Reference Manual for 8086-Based 
Development Systems, 121627 

© §8086/8087/8088 Macro Assembler Operating Instructions for 8056-Based 
Development Systems, 121628 


se we town — 
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Auxiliary Product Manuals 


The following manuals describe auxiliary products: 

° PL/M-8&6 User's Guide for 8086-Based Development Systems, 121636 

© Pascal-86 User’s Guide, 121539 

® MCS-80/85 Utilities User’s Guide for 8080/8085-Based Development Systems, 


121617 
© 8089 Macro Assembler User’s Guide, 9800938 
et © JCE-86 In-Circuit Emulator Operating Instructions for ISIS-I] Users, 9800714 


® JCE-88 In-Circuit Emulator Operating Instructions for ISIS-I] Users, 9800949 
° iSBC 937A Intellec-iSBC 86/12A Interface and Execution Package, 9800743 


° RBF-89 Real-Time Breakpoint. Facility Operating Instructions for ICE-86 
In-Circuit Emulator Users, 9801018 


© Model 740 Hard Disk Subsystem Operation and Checkout, 9800943 


Notational Conventions 


UPPERCASE Characters shown in uppercase must be entered in the 
order shown. You may enter the characters in uppercase 
or lowercase. 


s italics Nalics indicate variable information, such as filename or 
address. 
[] Brackets indicate optional arguments or parameters. 
(ise : . 
te ; { } One and only one of the enclosed entries must be selected 


med unless the field is also surrounded by brackets, in which 
case it is optional. 


5 eee ee At least one of the enclosed items must be selected unless 
the field is also surrounded by brackets, i in which case it is 
optional. The items may be used in any order unless 
otherwise noted. 


pak . Ellipses indicate that the preceding argument or 
: parameter may be repeated. 


punctuation Punctuation other than ellipses, braces and brackets must 
be entered as shown. For example, the punctuation 
é shown in the following command must be entered: 


Qe 8 ae bes 


Tyee ee gts 


SUBMIT PLM86(PROGA,SRC,’9 SEPT 81°) 


fame 


inpDtdine: In interactive examples, input lines and user responses are 
printed in white on black to differentiate input lines from 


sysytem output. 
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CHAPTER 1 


SYSTEM OVERVIEW 





The Intellec Series II] is an advanced microcomputer development system that:pro- 
vides two execution environments and two development facilities: an 8086 execution 


Cr 


mode and applications debugger, and an 8080/8085 execution mode and debugger. 


This chapter provides an overview of: 


The basic system 

System software components 
Dual execution modes 

The Intellec terminal 

Disk drives 

Disk drive configurations 
Disk characteristics 

Disk files 


’ The Basic System 


The basic system, shown in figure 1-1, contains the following: 


An 8085 processor 
64k. bytes of memory available to the 8085 processor 


‘An 8086 processor 


128k bytes of memory available to the 8086 processor 


8080/8085 1/O interfaces for teletypewriter, paper tape punch and reader, line 
printer, Universal PROM programmer 


An integral single-density flexible disk drive 


Figure 1-2 shows a system with an external dual drive flexible disk unit; figure 1-3 


shows a system with a hard disk subsystem. : ' 


System Software Components 


The following system software components are supplied with the Intellec Series III 
Microcomputer Development System: 


po 8 ae sage , 


Monitor—provides system start-up, peripheral device 1/O, and debugging of 
your 8080/8085-based software as described in Chapter 5. 


IS1S-l]—provides disk 1/0, file management, and program execution in the 
8080/8085 or 8086 execution mode as described in Chapters 3 and 4. 


RUN 8086—provides 8086 execution mode as described in Chapter 4. 


DEBUG-86—Provides symbolic debugging of your 8086-based software as 


described in Chapter 6. 


Co et rc 
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Figure 1-1. Basic System 121609-14 





Figure 1-2. System With External Flexible Disk Drive Unit 121609-1 
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| 8080/8085 Execution Mode 


The following fuiiétions operate in the 8080/8085 execution mode: 
: = AIL ISIS-I1 console commands peer RUN and its subcommands ° 











Bua: Execuien Meee. 





_ Monitor commands 









| You load ‘and execute y ur 8080/8085 executable programs by simply entering the 


8086 Execution Mode _ 





The following functions operate in the 8086 execution mode: 


° The RUN command, which invokes the 8086 mode 
e The RUN subcommands, DATE, WORK, and EXIT 
© DEBUG-8&6 commands 


You load and execute your 8086 executable programs by entering the RUN ¢ com- 
mand and the name of your program. ra 
To use ISIS-I] console commands, you must first exit to the 8080/8085 mode 
described under the RUN and EXIT commands at the end of Chapter 4. 


Figure 13. System With Hard Disk Subsystem 121608-2 , 
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System Overview Series II] Operating Instructions 


Each program displays a prompt character, as f ollows: 


3 








Program Prompt Mode 
IS1S-I -{hyphen) 8080/8085 
Monitor . (period) 8080/8085 
RUN - > (angle bracket) 8086 ra 
DEBUG-86 * (asterisk) 8086 a 
<The Intellec Terminal 
This section describes the display area, keyboard, and control panel of the Intellec 
terminal. 
The Display Area 
= . The video screen, shown in figure 1-4, has a display area that is 80 characters wide 
and 25 lines long. ; 
’ Every character typed at the keyboard is displayed on the screen. A cursor (a blink- 
ing underscore) indicates where the next character will be entered. 
You may use special features of the display when creating files with the CREDIT 
Text Editor (see the JSJS-JJ CREDIT CRT-Based Text Editor User’s Guide). 
ISIS-Il CAT-BASED EDITOR V2.0 
OLD FILE SIZE=120 BLKS LEFT=488 
7 fe =f Figure 1-4. The Display 121609-3 
's . The Keyboard 
. The keyboard, shown in figure 1-5, is your interface with the system. From the 
; % keyboard you control the system, enter data and commands, and request data. 


The data you enter at the keyboard is stored in a line editing buffer until you press 
the RETURN key or enter 122 characters. You can edit the contents of the line 
editing buffer with the line editing characters described in Chapter 3,-Line Editing. 


1-4 
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RUBOUT 


Escape 


(ESC) Cursor 


Control 
Keys. 





Control 
({CNTL) 


Repeat 
(RPT) 


ae 


RETURN 


Figure 1-5. The Keyboard 171609-4 





C The keyboard is a typewriter-style electronic keyboard. In addition to the standard 


a typewriter keys, the keyboard has other keys that perform specialized functions, as 
follows: 


CNTL The CNTL (Control) key changes the function of certain 
predefined alphabetic keys. A key whose function is changed by 
the CNTL key is called a control character. Control characters 
are defined throughout the manual. Examples are CNTL-R, 
CNTL-S, and CNTL-Q. To enter a control character, hold 
_ down the CNTL key and type the designated letter. A control 
character is entered into memory as one character, but is 
displayed with an up arrow, asin tR. a pe 


ESC The ESC (Escape) key.terminates the line edited input vin 
mi 8080/8085 mode. The ESC key displays as a dollar sign (S$). 


RPT. The RPT (Repeat) key provides multiple entry of other ‘keys. 
cowocuers 2” When RPT: and a second key are held down, the function of the. : 

‘-. second key. is-repeated until the RPT key is released. For — 

~ example, to delete several characters from the current input line; 

“press. both:the-RPT and the RUBOUT keys until the desired” 

number of: characters are deleted. The RPT key functions with = — 
= eCNTL, SHIFT, HOME, and TPWR keys. 















“ The RUBOUT ey deletes ne preceding character from both the. ae 


RUB . 
“display. and the line editing buf fer. Repeated usage is allowed... eet 





RETURN The RETURN Ley enters hes carriage return and line feed 
= characters. The use of the RETURN key in examples of input 
lines i is indicated by <cr>. 
TPWR-:”—s« The TPWR CLypewriter) bey ae lowercase entry (latched 
: < position) or uppercase entry (unlatched position) of alphabetic - 
* characters. the TPWR ae functions with the alphabetic keys 
© only. : 


ped ob bat: 


- HOME .__—‘ The HOME key ae with Ps wae Text Editor (see the 
ISIS-1] CREDI T CRT-Based Text Editor User’s Guide). : 
(arrows) _‘ The four keys with arrows are cursor control keys and are used 
with the CREDIT Text Engr: 
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Figure 1-6. The Control Panel 121609-5 








-—TheControlPanel 


The system control panel, shown in’ figure 1-6, contains the following switches 
and/or indicators (right to left): 


POWER The POWER switch (square white button) turns on the 
power to the basic system console including the integral disk 
drive and gives control of the system to the Monitor. 


RESET  -- If a system disk is in drive 0, the RESET switch loads the 
~~~ ISIS-II operating system into 8080/8085 memory and gives. 
control of the system to ISIS-II; if a system disk is not in 
drive 0, it restarts the Monitor. 
ae The RUN diester light remains on while system power is 
8080/8085 processor is not in a halt state. 



















Interrupt 0 isa manual i interrupt. When you press interrupt ns : ‘ 
0, “processing terminates and control of the system is 
transferred to the Monitor. 








In 8086-mode, you can use CNTL- D to interrupt processing 
id nter DEBUG-86. : 





Interrupt 1 is a manual interrupt. |. When you press interrupt 
1, -processing. terminates and control of the system is 
transferred to ise I] if a syste disk i is in drive 0. 


In. 8086 mode, you can use CNTL-C to interrupt processing: 
and return control to RUN or ae Il depending on how: 
RUN was invoked. =~ ' 


pe? wet eeyt 


Interrupt 2 is reserved for system usage. 


. Interrupts 3, 4, 6, and 7 can be used to generate Multibus 
interrupts if you make allowances for software products 
contained in your system. = 
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‘> In 8086 mode, i interrupt 5 must not be used. 
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Disk Drives 


Hard disk subsystem controls are described in Chapter 2 under Operation of 
Systems Containing Hard Disk Drives. 


Flexible disk drives are shown in figure 1-7. The front of each disk drive consists of: 


@ Adisk drive door = : 
® A drive door release button, which opens the drive door and releases the disk for 
beet removal 


ge 


° - Adrive indicator light, which is lit during disk input/output operations. 


In addition, the external drive units shown in figure 1-7 (b) and (c) contain a power 
switch and on/off indicator light 
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ORIVE DOOR 






DRIVELIGHT . 


ORIVE DOOR 
RELEASE BUTTON 









- “4a) INTEGRAL FLEXIBLE DISK DRIVE 


ON/OFF font 
INDICATOR ee ee 





CN OS “ POWER SWITCH 
ON/OFF INDICATOR ~ . 





(b} LOW-PROFILE EXTERNAL ee : ic} HIGH-PROFILE EXTERNAL 
FLEXIBLE DISK DRIVE UNIT = FLEXIBLE DISK DRIVE UNIT 
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Figure 1-7, Flexible Disk Drives . 123608415 
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Disk Drive Configurations 


The Series 11] supports up to eight drives, including single- and double-density flexi- 
ble disk drives and hard disk drives. Table 1-1 describes the possible disk drive con- 
figurations and drive numbers for each. 


You will note in table 1 i that hard disk drives are always numbered drive 0 fer the 
fixed hard disk platter, and drive 1 for the removable hard disk platter. Flexible disk 
drives, however, are assigned drive numbers according to the system confi iguration. 


= 2 aa 


Fe . Table 1-1. Series III Disk Drive Configurations 













Drive Numbers 









H = Hard disk 
F = fixed platter of hard disk 
R = removabie platter of hard disk 
D = Double-density flexible disk 
1S = integrated single-density fiexible disk 
ID = Integrated double-density flexible disk 
* = Notavailable © 
Parentheses ( ) indicate optional drives within the particular configuration. 





Disk Format Characteristics 


he Intellec Series 1] Microcomputer Development 
‘ ch. A flexible disk formatted in a single-density disk 
‘drive has 26 sectors per track: a flexible disk formatted ina double-density disk drive 
has 52 sectors per track. Each: sector contains 128 bytes. 













Once a flexible disk is formatted i ina Fngle: or double-density disk drive, it must tbe ; 
clonal to be used i in drive er a different density. A flexible disk is shown i in | 





a a Disks — 


Hard disk platters contain 400 tracks on each of two surfaces. Each track has 36 
sectors of 128 bytes. The system translates this data format into 200 logical tracks, 

~ with 144 logical sectors per logical track. Each hard disk subsystem contains two 
hard disk platters, a fixed platter in drive 0 and a removable cartridge in drive 1.A 
removable cartridge is shown in figure 1-9. 


ges ao past 
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Figure 1-8. Flexible Disk : 121609-7 


ins ly the files necessary fo or the creation and storage 
ng more space for data than on a system disk. 





Wher he system is reset with an ISIS- II system disk in the appropriate drive, the 
opening ae initializes ee control of the system. 






b- o be gees 


Al system start-up, only the essential ISIS- II files are loaded into memory. IsIs- Il 
command files remain on disk until you enter a command that calls them. <The 

-. required programs are then loaded into memory and executed. After the commtand 

-- program has completed its functions, the memory it was using is again available. 
This technique gives you the full capabilities of the operating system and lets you 
‘reserve most of the memory space for your work. 


é 
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Each file on a disk has a name. JSIS-I] program files come with assigned names; you 
name each file you create. To access a file, you need only specify its name, not its 
address. * 


The four basic types of files are: 
® Format files that are used by ISIS-II for disk formatting. 


’ © System files that contain both the basic system programs and the command 
programs PA erie ha teehee on, 
ry ® Program files that you create . 


oye 
@ 


-Data files that are used by your programs or by ISIS-I] 
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CHAPTER 2 


SYSTEM OPERATION 





This chapter provides tutorial information on how to operate the system, inclnding 
the following functions: ah 


® Care of disks ; As 

@ Operating precautions 

© "Flexible disk insertion and removal 

e Start-up and shut-down procedures for systems containing flexible disk drives 

e Flexible disk formatting procedures 

e Cold start and hard disk formatting procedures for systems containing a hard 


og 't@ . 


_ disk unit 
Pee e Hard disk cartridge installation and removal 
eS ). @+- Subsequent start-up and power-down procedures for systems containing a hard 


ES ~~ disk unit 


The first half of the chapter describes systems containing flexible disk drives; the 
second half describes systems containing hard disk drives. 


“Operation of Srsteme Containin: Flexible Disks 

















: Care of Flexible Disks 


_. The flexible disk is a y eoeLetieciive and convenient medium for the storage of data. 
. With proper care, you can ensure continued trouble-free reading and w riting of flex- 
ible disk files. Specific precautions are: 


umn the flexible disk to its envelope when not in use - 
‘Do not touch or clean.the recording surface _ 
Do nots smoke when handling the flexible disk - 
D not bend th  flexit 








n the disk label, not Pencil c or ball point pen 





For information concerning the poeratag. an. storage environment. ‘see the Intellec 
Solna Ill Microcomputer De cpment System Ynstallation and Checkout Manual. 


Flexib Disk System perating Precautions 






“SE The following action damage or modify the contents of a flexible disk: 


SAT Turning on or turning off the power to the system or to an external disk drive e 
pee unit with a flexible disk already inserted in the drive. ee ee 


: e Opening the disk drive BOr while the andicater light on the drive door release 

eg oo buttomis ons geen 85 ms 

a e Removing a disk while the. system is not at the ISIS- 1] level (when the ISIS- W 
prompt character is not displayed). - 


° Pressing the RESET switch while writing ‘fornalion on the flexible disk (i.e., 
the indicator light on the drive door is on). 


ible ¢ disk or use paper clips or other mechanical devic ices on nit = Le Sh 
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Flexible Disk System Start-up Procedure 


To start up a system containing flexible disk drives only, follow these steps: 
1, Turn on the power switch on the console control panel. 


2. Press the RESET button. The system displays the Monitor sign-on message and 

prompt character (a period): os 
SERIES II MONITOR, Vx.y a. 
e : . - 

(x.y is the version and release number of the M onitor.) 

3. If you have an external disk drive unit attached to your system, turn on the 
power to the drive unit. 

4. Insert the ISIS-I] system flexible disk in drive 0 as described in the next section, 
Flexible Disk Insertion. 


5. Press the RESET button. This loads the ISIS-I] eee system files from disk 


intomemory. 
% The system displays 1 the 1SIS-I1 sign-on message and prompt character (a hyphen): 
So ISIS-I1, Vx.y. 


(x.y is the version and release number of ISIS-II.) 
6. The system is now ready to accept a command from the console. 


NOTE 


After you press RESET in step 5, the ISIS-II prompt (a hyphen) should 

be displayed. If the prompt displayed is a period (indicating that the 

Monitor is still in control), check for one of the following conditions: a 

non-system disk in drive 0, an incorrectly installed disk, or a dis- 
connected: drive 








Flexible Disk Insertion x a 





a the drive ‘door has a vertical ¢ ‘opening, insert 1 the flexible disk with the read/write ee 
slot first and-the write-protect lab di dow n pas f ce 2-1). oa 














: “Check” a ‘the ast. See displayed is the ISIS- It prompt nares (a 
; M hyphen) indicating that ISIS-I1 is in control of the system. 


“if the last character displayed i is nota hyphen, press interrupt 1. 


: 2. Check that the indicator light on the drive door release button is off (see figure 
2-3). ho ES : 

if the light r remains ‘on ‘for more than 10 seconds and a read operation is not in 

- progress, disengage the drive by pressing the RESET button, holding RESET 

pressed if necessary until the light goes out. 


: Sb 
P< 8 Be bag 
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« 4 
nsertion, Vertical Position 
Figure 2-2. Flexible Disk Insertion, Horizontal Position 121609-10 
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‘3. Press the drive door release button. The door automatically opens and releases 
the flexible disk... 4 


4. Remove the flexible disk and place it in its protective envelope. 


Flexible Disk System Shut-Down Procedure 


When you are ready to turn off the system, follow these steps: 
J. Remove all flexible disks as described in the preceding section. 
oN: “s 2. Turn off the power switch on the external disk drive unit if any. 
"3. Turn off the power switch on the console control panel. 
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| Flexible Disk Formatting Procedures 


Before using a blank disk, you must format it. Examples below provide step-by-step 
disk formatting instructions for systems with multiple flexible disk drives and for 
systems with a single plexible disk drive. 


The flexible disks required are: . 


if 
° A source disk, referred: to as the system or source disk, that contains ISIS 
* system files. See = 
. -@ Adlank disk, referred to as isthe output disk. 
Before formatting a flexible ‘disk, a reflective tab (provided with intel disks) 
must be Placed over an. ‘Open mE Pros) slot, as shown in figure 2-4. 


ES 
“nganve 





ae f_ 1B ON WRITE-PROTECT 
Bushs PROTECT SLOT SLOT 


Figure? 2-4. Flexible Disk Write-Protect Tab 1271608-13 







an the instructions given in example 1 you can produce any of three types of disks: 
. A basic system disk. 
A basic non-system ‘disk 


"3. K duplicate back-up “dis that « contains all the files on the source disk. (It isa 
soot’ cre to parayes a bac up. copy of the important files on your disks. y- 








“vg To format a basic system disk: 
= To format and create a duplicate back-up disk: 
~ Sed 


To format a nonsystem disk: 


-RIW Se 


Cro eS er 





2-5 





System Operation 


pane 


fetes 


2-6 


“e 


pe) ou bese 


7. The system displays the name of each file copied. 
8. The disk is now ready to be Used on the system. 


For additional information and examples of the FORMAT command, see Chapter 
4, 


Example 2—Formatting a Flexible Disk in a System Containing a 
Single Flexible Disk Drive = 


It is recommended that all disks used on a single disk system be formatted as a 
system disk and that you write-protect your source system disk in case the two disks 
are switched. 


1. Turn on the system power and press the RESET switch. The system displays the 
Monitor sign-on message and prompt character (a period). 


2. Insert a system disk into the disk drive. 


3. Press the RESET button. The system displays the ISIS-I] sign-on message and 
prompt character (a hyphen). 


4, Enter the following command: ; 
mIDISKSF0=HYDISKsSe<cr>) 

§. The system displays: 
SYSTEM DISK 

6. The system then displays: 
LOAD OUTPUT DISK, THEN TYPE (CR) 


The system waits for you to remove the system disk, insert the ouput disk, and 
press the RETURN key. 


7. The system then displays: 
LOAD SYSTEM DISK, THEN TYPE (CR) 


The system waits for you to remove the output disk, insert the system disk, and 
press the RETURN key. 


8. When the new disk is formatted it can be used on the system as a system disk. To 
produce a duplicate back-up disk, continue with the remaining steps in this 
procedure. 


9. When the ISIS-II prompt character (a hyphen) is ae enter the following 
command: 


a COPY@tl*St 0 Ste OK TO 


where *.* is the wild card designation that matches all filenames. All files 
remaining on the source disk are copied to the output disk. 


10. The system then displays: 
LOAD SOURCE DISK, THEN TYPE (CR) 


If the source disk is already inserted in the drive, press the RETURN key 
without swapping disks. If not, swap disks and press the RETURN key. 


11. The system then displays: 
“LOAD OUTPUT DISK, THEN TYPE (CR) 
’ Swap disks and press the RETURN key. 
12. Repeat steps 10 and 11 in accordance with the messages displayed, if any. 
13. The system displays the names of each file copied. 
14, When the copy is completed, the new disk is a duplicate back-up disk. 


peas ghee 


For additional information on the IDISK and COPY commands, see Chapter 4. 
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System Operation 


Operation of Systems Containing Hard Disk Drives 


- Hard Disk Subsystem Controls 


‘? 





The front panel of the hard disk. drive includes four backlighted operating switches 
and two status indicators (see figure 2-5 and table 2-1). A brush indicator angjtwo 
cartridge holddown arms are mounted on the top of the disk drive. Two citguit 
breakers are positioned on the back panel. ar 


Pied 


. Table 2-1. Hard Disk Drive Controls and Indicators 


Control or indicator 


MAIN Circuit Breaker (CB1) 
+34 VOLT Circuit Breaker (CB2) 


START/STOP Switch/indicator 


READY indicator: 
ACTIVE Indicator 


FAULT ue 2 


WRITE PROTECTICART 
Switch/ indicator. & 


WRITE Spies sea ae 


- Switch/ indicator 





ped oo bast 


Brush Indicator — 


Cartridge Hoiddown Arms 


Care of Hard Disks és : 


and the disk. 


Applies main ac to disk drive. 


Applies de voltage to disk drive electronics; not 
accessible to operator (covered by switch plate). 


Alternate-action switch with indicator. When pressed, 
applies power to spindle motor and initiates the first 
seek mode; indicator lights to indicate power is applied 
to spindle motor and spindle is rotating. When pressed 
the second time, removes power to spindle motor; indi- 
cator remains lighted until spindle stops rotating. 


NOTE 


The first seek mode is completely automatic 
and requires approximately 65 seconds to com- 
plete. In the event of a fault during this time, 
heads will automatically go to emergency 
retract and spindle will stop. 


Lights when spindle is up to speed, heads are loaded, 
and disk drive is ready for use. 


Lights when disk drive is actively engaged in any mode: 
direct seek (forward or reverse), return-to-zero seek, or 


read/write/erase. 


| Lights when any fault (except power failure) exists. 


Pressing switch resets fault logic. 


Alternate-action switch with indicator. Prohibits writing - 
4 Of erasing on cartridge disk. Indicator lights to indicate 


that cartridge is protected. 


Alternate-action switch with indicator. Prohibits writing 
or erasing on fixed disk. Indicator lights to indicate that 
fixed disk is protected. 


Indicates position of brush motor. Allows brush to be 
manually moved. 


Hold disk cartridge in place. interlock circuits prevent 
arms from being lifted as long as spindle is rotating. 





The hard disk drive assembly is extremely sensitive to contaminants on the hard disk 
platter surface. The head does not make contact with the disk platter, but rides 
about 1.14 microns above it. If contaminants such as a human hair (100 microns in 
diameter), a smoke particle (6.35 microns), fingerprints, or dust come between the 
disk drive head and the platter surface, the contact will usually destroy both the head 
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Figure 2-5. Hard Disk Drive Subsystem 171600-6 





Follow these precautions to ensure proper operation and maintain data integrity: 
se e Clean any dust or dirt from the cartridge cover and drive chassis with a lint-free 
hap Clothe es 

® Allow nothing to touch the disk surface. 


e Inspect the disk surfaces periodically with a bright, directional light. If the disk 
is dirty or scratched, it must be serviced by your Intel service representative.: 


© Keep liquids away from the hard disk drive. 
¢ Donot smoke in the hard disk drive area. 


e When you first bring a cartridge into a new operating environment, allow at 
least one hour for the cartridge temperature to stabilize. 


pee oo boy? 
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Hard Disk Subsystem Operating Precautions 


Follow these precautions to maximize subsystem performance; 


® Always keep a cartridge installed and disk drive cover closed. This prevents dust 
and foreign Particles from contaminating the disk cartridge or fixed disk 


mechanisms. ai 
e If you hear a pinging or scratching sound (caused by head-to-disk contact), siop 
we : the disk drive by pressing the START/STOP switch and call a service 
representative. 
- ° Always follow the disk cartridge installation and removal procedures described 
in this chapter. 


® Never override any interlock switch or mechanism in the subsystem. 


‘Hard Disk System Cold Start 


Use this procedure when you first set up the hard disk subsystem for operation or 
when you need to re-format the system hard disk. For day-to-day operation, follow 
the procedure in the Hard Disk System Subsequent Start-up section. 





Drive 0 contains the fixed hard disk platter, drive 1 contains the removable hard disk 
cartridge, and drive 4 is the integral flexible disk drive. (If your system has a single- 
density integral drive and an external flexible disk drive unit, drive 4 is the righthand 
drive on the external unit. 


The system flexible disk and the fixed hard disk must contain the same version of . 
ISIS-I]. For Series I, you must use version 4.1 or later of ISIS-II. If the fixed hard 

disk does not-contain the correct version, copy any files to be saved to another disk, 

then ref ormat the fixed hard disk. 


Booting the system on.is.as follow Ss: 

1. Apply power to the system console and press the RESET switch. 
: 2. Apply power to the external flexible drive unit if any. 

-3. Power up the hard disk ‘subsystem as follows: 


a a. Set the MAIN circuit: breaker (CB1) to ON. Make sure the blower motors 
GEE nee are: running. If. the blower motors do not turn on, call your service 
representative. 


d. Install a disk cartridge as s described i in the next section, Hard Disk Cartridge 
. Installation. «. 


H c. If the FAULT fndiciey comes on, perform steps 1 through 3 of the FAULT 
; operation procedure in this chapter. | 


d. Press the START/STOP switch to turn the spindle motor off. 


4. Set the WRITE. PROTECT arenes to OFF unless write protection is desired 
(see figure 2-5). . 


5. Insert a system flexible disk i in ‘drive 4. 
6. Press the RESET switch on the console. 


7. The system displays the ISIS-II sign-on message and prompt character (a 
hyphen): 


. 1S1S- I, Vx.y 











g:? Bb bag® 


spat gee 


(x.y is the version and release number of ISIS-I1.) 
8. Press the START/STOP switch to turn.the spindle motor on. 
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9. Wait until the READY indicator is lit (65 seconds). 
10. At the console, enter the following command: 


od ST LOFORMA PESO SSSISx=yASSERON MM Kcr 
where x.y corresponds to the ISIS-II version and release number displayed in 
step 8 above. This step formats the fixed hard disk in drive 0 as a system hard 
disk. Wait until the formatting operation is completed indicated by an ISIS 
prompt before going to step 11. i 
11. Press the Interrupt 1 switch on the console control panel. Drive 0 is now’ “the 
- system disk drive. _ 
. 12. To format the fenbeable cartridge as a non-system disk, enter the following 
command: 


ma PORMAT&CTACNONSYSSDSK<c7> 


13. The system is now ready to accept another command from the console. 


“47 


NOTE 


-Allinterrupt 1 and ISIS-II aborts reboot from the system hard disk in 
_ drive 0. The system flexible disk .in drive 4 is required only for system 
start-up and reset (RESET switch) operations. 


Hard Disk Cartridge Installation 
Stabilize the disk cartridge temperature to the disk drive environment before it is 
installed. Be sure that the disk is clean, then install it as follows (see figure 2-6): 

"1. Check that the MAIN circuit breaker (CB1) is ON. 

. Check that the START/STOP indicator is not lit. 

. Raise the disk drive cover... 

. Lift the cartridge holddow narms. 


. Separate the dust cover from the disk cartridge by sliding the cover “release 
bution to the a and. lifting 4 the cartridge handle. Remove and set the dust 
cover aside. =." = 
Check that brush indicator slot i is aligned with the black line. If not, align it with 
~~ acoin or similar object. 


Gently 5 place the disk cartridge onto the spindle hub with head opening toward 








Replace the soe cover, Soper end down, over the disk cartridge. 
. Position the cartridge holddown arms over the cartridge. 
Close the disk drive cover. =. 


. Press the START/STOP switch. If the spindle motor does not rotate, disk 
cartridge is not installed properly (press START/STOP and perform steps 4 
through 12 again). 


14. If the spindle motor rotates, wait until the READY indicator is lit (65 seconds). 


Hard Disk Cartridge Removal 


eed ee etie 


To remove a hard disk cartridge, follow these steps: 
}. Check that MAIN circuit breaker (CBI) is on and that the blower motor is on. 
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Figure 2-6. Hard Disk Cartridge Installation 
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NOTE 


lf the MAIN circuit breaker is on but the blower motor is not, the 
cartridge must be removed by a service representative. 


2. Check that the START/STOP indicator is not lit. 


3. Check that the brush indicator slot is aligned with the black line. If not, align j it 
“with a coin or similar object. = 7 
Raise the disk drive cover. me 
Lift the cartridge holddown arms. . 

-Remove cartridge dust cover and set aside. 


Hold the cover release button, lift the cartridge handle, and lift the cartridge 
clear of the disk drive spindle. 


Place the dust cover in position on disk cartridge and release the cover release 
button. 


vg 


9 


NOTE 


To prevent dust and foreign objects from entering the disk drive, never. 
on leave the unit open without a cartridge in place for an extended period 
of time. 


_” Hard Disk Subsystem FAULT Operation 


The FAULT indicator comes on when a nondamaging fault exists, such as when 
more than one head is selected. 


If a momentary power failure occurs, the FAULT indicator does not come on. In 
such an event, the hard disk heads go into emergency retract and the unit stops. The 
unit automatically restarts when power returns to normal. 


If the FAULT indicator is lit, follow these steps: 
1. Check that the system flexible disk is in drive 4. 


2. Press the FAULT switch. If the FAULT indicator goes out, and remains out, 
P resume normal operation. If not, continue with step 3. 


3. Press the START/STOP switch to remove power from the spindle. Allow 
Spindle to stop, then press the START/STOP switch again. Allow spindle to ' 
ae reach operating speed. 


If the FAULT indicator goes out, resume normal operation. If not, proceed to 
step 4. 


4. Press the START/STOP switch to remove power from the spindle, and contact 
a service representative. 


Hard Disk System Power-down Procedure 


To power-down the system, follow these steps: 
1. Remove all flexible disks as described under the Flexible Disk Removal section. 
2. Press the START/STOP switch. The following occurs: 
© The READY indicator extinguishes. 
‘ © The heads retract. 
© The brush retracts. 
® The START indicator goes out after the spindle stops rotating. 
¢ The cartridge hold-down arm interlocks open. 


po se baye 
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DEVICE/FILE MANAGEMENT 


You control all device and file input/output functions by means of the 1SIS-II con- 
sole commands described in Chapter 4 and the pathnames (file accessing form@fs) 
described inthischapter. 


oe 


‘¢ 


ISIS-II handles disk I/O, and calls on Monitor routines for I/O to other devices. 


This chapter describes the following: 
® Device/file accessing 
e Device names 
® Filenames 
® Disk directory 
coe ® The system console — 
® Line editing 
® Operator controlled pauses 
® Interrupting Program Execution 


The chapter includes references to: . 

e Console commands (such as COPY, IDISK and FORMAT) which are described 
in Chapter 4. 

e System calls (such as OPEN, CLOSE and CONSOL) and 1/0 driver routines, 
which are described in the Intellec Series III MANSOCDAPHICE Development . 
System iOS amneh 's Reference Manual. 


Device/File Accessing 


ISIS-II provides a simple but uniform method of identifying each device and each 
= disk file.. The assignment of logical names allows you to access system resources ‘ 
Che without requiring eOu Tests 
The system maintains a record of the device addresses established when the system is 
_ configured-and a directory on each disk of file addresses. The system converts 
logica] names to true addresses during processing sequences. 


When you create a file ona disk, the system enters information about the file into 
the disk directory. When you delete a file, its entry is deleted from the disk directory. 


..- Device Names 


Bro oe best 


‘The pathname for a device other than disk files is a system-assigned name in the 
form: 


:device: 


rebaw gee 


ISIS-I] assigns names to the following kinds of devices: standard devices, generic 
devices, and nonstandard devices. 
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Standard devices are predefined devices for which 1/O driver routines are speci- 
fically provided. System names assigned to standard devices are: 


3FO: 
through 
sF9: Directory on the disk in drive 0 ...9 
s3Tis Teletypewriter keyboard <a 
- : 270: Teletypewriter printer & 
-3TPs- Teletypewriter punch 2. 
- STR: _- Jeletypewriter reader 3 
‘ sVIs.. Video terminal keyboard i 
- 2V03 Video terminal screen 
sHP: © High-speed paper tape punch 
sHR: High-speed paper tape reader 
"eLP: Line printer 


The generic devices, system console and byte bucket, do not exist in their own right, 
but Pree en. fori sash or output of your data. 


Logical names assigned to the device being used as the system ‘console are: 


"Console sacat ‘file. 
Console ouput fi file 


~ The keyboard and screen are normally :Cl: and :CO: respectively. However, you 
can establish some other device, such as a disk file, as :Cl: or :CO: with the 
~~ CONSOL system call. 


‘You can use the byte bucket for data you do not want saved or displayed. The 
iat! name aes to the sii pueket is: 


















:BB: “Byte bucket oe 


Nondlandard divines are those devices for which 1/0 divers are not specifically Pen 
vided. The system names for nonstandard devices are: ; 
- “Paper tape: Fender le 
-- Paper tape reader 2 
Paper tape punch 1 
Paper. tape punch 2 
“Line printer: 1. te 
--Console input device ; 
Console output device. 












‘fy you use any ‘nonstandard device in n your applications, you must write your own. 
1/O driver routines and define the nonstandard device with the Monitor I/O defini- 
tion routine. Nonstandard console devices can be assigned to :CI: and :CO: via the 
“CONSOL aysion call. 








ns Filenames" : 


All ISIS-II fi les come with system-aisigned names. When you create disk files with a 
text editor such as CREDIT, you assign a name to that file. The name may be 
expanded with an extension that further identifies the file. 


go Boba! bs 


Filename — 


yee 


‘The term filename refers to both the name of the file and the extension, if any. Each 
new file you create must have a unique filename. 
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The general format for filename is: 


2 


nameé.extension — - 
: 1-3 alphanumeric characters 


1-6 alphanumeric characters at 


where ae 4 
bead . Pe 


name is a one- to sccharaciet name you assign to a file. The characters must be 
. alphabetic or numeric. 


extension is a one- to three-character modifier you create for name. An .exten- 
sion is optional when the file is created, but if .extension is specified, it must 
always be used when referencing the file. 


© | Default Extensions 


Default extensions are siden ned extensions that the system assumes under certain 
programs when you do not supply one. Default extensions are designed to save you 
time when entering commands. ~ 


When you specify any 8086 filename with no extension under the RUN program, the 
sysiem assumes an extension of .86. If you specify an extension (or a name and 
period with no extension, as in TEST2.), the default extension is not assumed. 


os : “When you specify an 8080/8085 filename with no extension, some 1S1S-I] programs . 


and the language translators a assume a default extension. 
os Examples 0 of def ault extensions are: ns 


' Feanalaict outpit 
IS-Il RUN program 












e “CSD: 4SIS-I] SUBMIT program 
| BAK - = $81S-ll CREDIT program 
eTMP ASIS-Ht LINK, Locate, Lib, CREDIT, and RUN programs 
-LNK -e ISISATLINK program 


4 These extensions < are re explained further dinder: the individual commands. It is recom- - 





mended. that you do not assign such extensions to your source program’s files. 


. _ Disk Fi File Pathname ee 








- 


po ob base” 


*. The pathname for disk less: : 
:Fn: filename: ? 


where 


:Fn: refers to the directory of the disk in drive n that contains the target file. The 
value n is an integer between 0 and 9 inclusive. If :Fn: is not specified, :FO:"is 
assumed. filename follows :Fn: with no intervening space, as in :F]1:MYPROG. 
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The following example illustrates the file pathname as well as a common use of 
extensions. _ , : 


:F1:PROGA.SRC  -for the source code 

:Fi:PROGA.LST -for the listing from the translator 

:F1:PROGA.OBJ -for the object code 

:FI:PROGA.LNK _ -for the linked object code 

:F1:PROGA -for the code locaied at absolute addresses for execution 


‘ 
aA. 


havent 


“If the disk that contains these files is moved to drive 2, :Fn: becomes :F2:. :Fn<"is 
- dependent on the physical location of the disk. 


a 


Note that all these files have the same name and are distinguished only by the exten- 
sion. Extensions allow you to distinguish between different files associated with a 
single program. 


Disk Directory 


on Files are accessed through a disk directory that keeps track of each file on the disk by 
fous its filename. 


A directory,on a flexible disk has space for 200 entries. A directory on a hard disk 
has space for 992 entries. This means that a flexible disk can contain up to 200 files, 
and a hard disk can contain up to 992. 


A directory entry contains identifying information about a file. For example, it 
includes the following items: 


® Filename 

@ Number of blocks allocated to the file 
@ Number of bytes.in the file Jength) 

© Attributes 


Figure 3-1 shows a directory listing obtained by using the DIR command. 





DIRECTORY OF :FO:X409 


NAME .EXT BLKS LENGTH ATTR NAME .EXT BLKS LENGTH ATTR_ 
ISIS .DIR 26 3200 IF ISIS .HAP 5 512 IF 
Isis .TO 24 2guy IF ISIS .LAB 54 6784 IF 
ISIS .BIN 94 11756 SIF ISIS .CLI 20 2407 SIF 
ATTRIB 40 4909 WSI coPY 69 8489 WST 
DELETE 39 4824 WSI DIR . 55 6815 wWSI 
EDIT - 58 7240 WSI FIXMAP 52 6498 WSI 
HDCOPY 4g 5994 WSI HEXOBJ 34 4133 WSI 
IDISK 63 7895 WSI LIB 82 10227 WSI 
LINK. 105 13074 wSI LINK .OVL 37 4578 WSI 
LOCATE 120 15021 wSI — OBJREX 28 3337 WSI 
RENAME - 20 2346 WSI SUBMIT 39 &821 WSI 

% SYSTEM.LIB 24 2849 ws FPAL .LIB 74h 9125 wSI 

: FORMAT 62 7789 

= 1272 


1272/4004 ELOCKS USED 


Figure 3-1. Directory Listing Example 
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Filename 


’ 


Each filename in the directory includes the extension if any. 


Blocks 

ISIS-I] treats a file as a string of bytes. Space is allocated to a file in complete. 28- 
byte blocks even though the last block in the file may be only partially used. In other 
words, a block is not shared by two files. When you delete a file, the blocks it 
occupied are released for reassignment by ISIS-II. 


For every 62 blocks of data, another block is required for pointers that specify the 
location of files. You can calculate the number of data and pointer blocks required 
by a file of N bytes with the following formula: 


63°(N/128)/62 © 


- Any result containing a decimal fraction is rounded to the next higher integer. For 
_ example, a file of 9000 bytes requires 


63°(9000/128)/62= 
63°70.31/62= 
72.152 | 

73 blocks required 


Length - 


The length of-a file is ; the nuraher of bytes contained. Length increases as a file is 
written and can be Bucries by other programs containing the system calls OPEN 


_ and SEEK. 


Attributes 


Four aabutes are associated with each file that may be set or reset (turned on or 


off) by the ATTRIB command or the ATTRIB system call: 


8 Invisible 
- ©  Write-protect 


° : Format. > 
e System 


When you create a file with the CREDIT Text Editor, or copy a file with the COPY . 
command, no attributes are set. (The COPY command C switch copies attributes.) —— 


. Invisible. The invisible attribute prevents files from being listed by the DIR- 


command unless you use the invisible (I) switch. System files on the system disks 
supplied with your system have this attribute set. : 


- 


©. 


Write-protect. The write-protect attribute protects files from being modified, 
deleted, or renamed. However, write-protected files are overwritten by the IDISK 


and FORMAT commands. 


Device/File Management 


3-5 


Device/File Management — 


Series Il] Operating Instructions 


Format. The format attribute protects files from being modified, deleted, or 
renamed. However, files with the format attribute set are overwritten by the IDISK 
and FORMAT commands. Files with this attribute set. are copied to a new disk by 
the FORMAT or IDISK commands. The format attribute should be used only with 
these files: ISIS.DIR, ISIS.MAP, ISIS.TO, ISIS.LAB, ISIS.BIN, and ISIS.CLI, 

plus ISIS.BAD if you have a hard disk.. You should not assign the format attribute 


to any other file, nor remove the format attribute from those files.. a 
a. 

Basic ISIS.* files are reserved-for system use: Intel reserves the right to modify? 

makethese files. inaccessible for Brac use. ri 


ete 


- System. Files. with. the system: attribute set are copied to a new disk. when you. 
‘- specify the & switch. wid: the FORMAT command. When you: use the IDISK. 
_. command, files: with the system: attribute set are not ausomatically copied; you can 
- selectively copy them with the COPY command. 






















as ‘The System Console | 


- The keyboard and: screen is the ‘initial systerr console.” The console can be changed 
to: another. device by: a: program executing a. CONSOL system call or by using the 
SUBMIT command. The ‘current console’ is the device currently serving as. aad 
whichmay ‘Ormay: not be Mesamees ine initial system console. 





The cpinsole: wine: device iti is: assigned: to; is. always.the source of system com- 
mands: The SUBMIT command directs. ISIS-IT to take commands.from a disk file... 
The SUBMIT file cam return: control. tothe: initial system console by. meansiof.a 
CNTL-Ex To: return: controk to: the SUBMIT file,. you. enter a CNTL-E from the: 
console. Jas 





Under ISIS-I the files:CI-a and CO: are pseudonyms for nedeviees serving'a: as con- 
sole input and: output: The :Cl= file is always the source of system commands. The 
:CO= filereceives: peeciea naa! the-echo: of:a command. These two files. are 
a ele pare! ae 


Line Editing 


Each: character youn on the keyboard is: - stored i ima line editin a buff er untit you. 

. press the RETURN: key or enter 2: maximunr of: 122 characters.. You: can: edit or — 
. . delete the contents of the line editing buffer by: using special non-printable editing: 

ee characters; Theline editing charactersare=. 





/RUBOUT "Deletes the preceding character from the line editing buffer and from. . 
: . the display.. Repeated usage is allowed. (On systems. using. a 
. tdletypewriter, RUBOUT echoes. the ccc Sharartes to "the 
Rel PE MERELY: noe 








ae CNTLP ‘Used before: amr editing character @ ceuding itself) to allow entry of © 
ie oe Ries ine Character EO: the line editing buffer. 


- 


eo) wey! ae 


CNTL-R Displays thecurrent contents of the line editing buffer. 


: CNTL-X. Delete the entire contents of the line editing buffer and displays a 
ae number sign (#) followed. by a carriage return and line feed. > 


° 
- 


 CNTL-Z Enters. an. end-of-file and deletes the contents of the line edxing 
. buffer and returns 0 bytes of data to caller. 
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Operator-Controlled Pauses 
ISIS-1] provides a pause facility that allows you to stop the output, inspect the 
display or printing, and then resume the output. The special control characters used 
are: , 
CNTL-S Suspends terminal output and delays program execution. 3 


CNTL-Q Resumes terminal output after the CNTL-S command is given. 


These control characters are not line editing characters and have no effect on input 
operations. 


interrupting Program Execution 


Interruption of program execution js described first for the 8080/8085 mode, then 
for the 8086 mode. 


8080/8085 Execution Mode 


INTERRUPT switches 0 and | on the Intellec front panel terminate-processing in 
8080/8085 mode. Interrupt 0 returns control to the Monitor whereas interrupt | 
permits ISIS-I] to retain control. Interrupt 1 can be used at any time to terminate 
processing. 


When interrupt switch 1 is pressed, the following occur: 
e All open files are closed in their current state. 
° The initial system console becomes the current console. 


e 6A fresh copy of ISIS-I] is read in from the system disk, and ISIS-I] prompts for 
a command (hyphen). 


To stop processing and pass control to the Monitor, use interrupt 0. To restart pro- 
cessing of your 8080/8085-programs at the point of interruption, enter a Monitor G 
command. (Execution starts at the location specified by the contents of the program 
counter.) 


To terminate processing and return to ISIS-II command Jevel from the Monitor, use 
the G8 Monitor command to close all open files, and restart IS1S-I1, which prompts 
for a command. This is equivalent to pressing interrupt switch 1 except that the 
Monitor masks all interrupts except interrupt 0, making iDUsTuPE switch 1 
inoperative when the Monitor is in control. 


To pass control from ISIS-I] to the Monitor do one of the following: 
® Press the interrupt 0 switch. 
e Enter the Monitor DEBUG command (described in Chapter 5). 


e Execute a LOAD system call with a transfer value of 2 (described in the Intellec 
Series III] Microcomputer Development System Programmer’s Reference 
Manual). 


To pass control from the Monitor to ISIS-I] enter a Monitor G8 command. 
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8086 Execution Mode 

Interrupt | performs the same functions in 8086 mode as in 8080/8085 mode. 

To interrupt 8086 program execution and enter DEBUG-86, use CNTL-D. 


-¢ 
To terminate 8086 program execution and close files, use CNTL-C. CNTL-C retifrns. 
control to the 8086 RUN program if you are in interactive RUN mode, and to IgiS- 
Il if you are in noninteractive RUN mode. For inf ormation on. interactive -and 
noninteractive RUN modes, see the RUN command at the end of Chapter 4, 


ra 
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ISIS-II console commands perform the following basic tasks: 
¢ Prepare a new disk for use by the system (i-e., format the disk) 


e Create, delete, and revise files and directories 


a 
@ e Convert object file formats” 
. © Execute your 8080/8085 programs 
© Execute your 8086 programs 
Command Categories 
ee The following ISIS-II console commands are associated with each of the preceding 
tasks: 
Disk Maintenance Commands 
IDISK Formats a new disk to a basic system or non-system disk. 
FORMAT Formats a new disk and copies files. 
FIXMAP = Maps bad sectors on a hard disk. ; ~ 
ols Maintenance Commands 
oR Displays the names of and information about the files listed. 
. within the disk directory. 
ce copy Copies a file from one device to another. 
HOCOPY Copies one hard disk to another. 
DELETE | Removes eaiarenees to a file from the directory and frees disk 


storage'space associated with that file. 





RENAME Changes the name of a disk file. 


~ ATTRIB Changes and/or displays the attribute(s) of a disk file. 


8080/8085 Program Execution Commands 


Bo 5h bgt 


filename Loads and executes an 8080 or SOSS program named filename 


SUBMIT Enters a file that contains commands to be executed. ‘ 
DEBUG Loads an 8080 or 8085 program if specified, and gives control to 


the Monitor. 


TO BER NA Pd hide, abd LE IOVS 


8086 Program Execution Commands 


wh | 


RUN Activates the 8086 execution mode and optionally executes an 
8086 program. The following commands control 8086 process- 
ing in RUN mode: 

° filename Executes an 8086 program named filename (see the 2RUN 
command). 

: pf 

° DEBUG Loads an 8086 program if specified, and gives control to 
DEBUG-86. This command is described in Chapter 6. 

* WORK Changes or displays the default drive used for workfiles. 

° DATE Changes or displays the system date. 

e €XIT Exits the RUN program and returns control to ISIS-II. 


File Editing Commands - 





File creation and editing commands for the CREDIT Text Editor are described in 
the following manual: 


e JISIS-II CREDIT CRT-Based Test Editor User’s Guide 


Program Control and Code Conversion Commands 


Program control commands (for Librarian, Linker, and Locator) and code conver- 

sion commands (for hexadecimal to/from object module format conversion) are 
“ described in the following manuals: . 

° MCS-80/85 Utilities User’s Guide for 8080/8085-Based Development Systems 

e IAP X 86, 88 one: since reba 's Guide for 8086-Based Development Systems 


Entering Command 





Your communication with 1s] through the system console. When you press 
coos RESET, ISIS-II signs on andi issues’ its prompt character (a hyphen): 


ito II Vx.y 





: where x = is the version and. release number of ISIS-I1. 


You can enter a Cormiand whenever the ISIS- II prompt is displayed. Each com- 
mand is entered as a command line and must be terminated by a carriage return or a 
line feed. When you press the RETURN key after entering a command line, a line 
feed i is automatically entered. 2a E = 


You can intersperse comment t lines with command lines. Begin each comment line 
with a semicolon. B 


ee 


You can correct or edit the current input line with the RUBOUT key. Other line 
- _ editing characters are described in Chapter 3, Line Editing. Once the RETURN key 
is pressed that input line can no longer be edited. 


ae +) 


The RUN and DEBUG-86 programs are the only ones that execute in the 8086 
mode. If the system is in 8086 mode, you must exit io 1S1S-1] before entering any 
other ISIS-II command program. 
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Command Syntax 
The general syntax of 1SIS-1] console command is: 


command parameters<cr> 


where t 
adie 
command is the name of a command program. + 
x 


parameters are one or more data required by the command. When you enter 
more than one parameter, separate them with commas or blank spaces unless 
noted otherwise under the individual commands. When a parameter consists of 
switches, they may be separated by spaces, but not by commas. 


Parameters enclosed in brackets ({ ]) are optional. If an optional parameter is 
omitted, default actions are PeHOrmen by 1SIS-I] commands as explained with each 
command: wg 


- In most cases a command i is executed when the carriage return is encountered. Any 
exceptions are noted under the individual commands. 


Specifying Disk Files 
~ The command syntax of many commands includes the following designation: 
:Fnifilename | 


_ Where. this format is shown, the following definitions apply unless otherwise noted 
ms past the individual command:. 


Fn: refers to he directory of the disk in drive n that contains filename. The 
value.n is’ an integer: ‘between, 0 and 9 inclusive. If :Fn: is not specified, :FO: is 
assumed. ee 
















S filename’ is . name. etand extension if any) of the target file. Enter filename 
; immediately after *Fn: with no intervening space, asin iF 1:MYPROG.. 











eS L Disk Maintenance Commands eS 













The commands described i in. this ection are 





= Formats a disk asa a system or ‘non-system disk. ee 





Seorna : “disk as a system « or Senay disk and copies” 
additional files. re ; . 





; FIXMAP : 


- : : : 





vl blank disk must be eseuated with dikes the FORMAT. or IDISK- ‘command 
before it can be’ used ‘on the system. You can format the disk as any of the following: 


° A basic system disk containing only the ISIS-II files necessary to start-up and 
operate the system and maintain the disk file directory. 2 


° A basic non-sy stem disk containing only the IS]S-I1 files necessary to maintain 
the disk file directory, leaving more space for data than on a system disk. 


* Asy stem or non- system disk containing additional 1S}S-IlI files. 


fa 
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You must use IDISK or FORMAT to convert a non-system disk 10 a system disk. 


If your system has at least two disk drives, use either the FORMAT or IDISK com- 
mand. If your system has a single disk drive, use the IDISK command.~ 


Use a disk formatted as either a single- or double-density disk only in a disk drive of 
the same density. If you wish to use that disk in a drive of a different density, format 
the disk again with FORMAT or IDISK in a drive of the desired density. 


. Table 4-1 shows the ISIS-II files copied for each FORMAT or IDISK commend 
shown. Note that the COPY command must be used in conjunction with IDISK. 


The information in this table applies only if your source disk files have the same file 
attributes set as those shown in the Attributes column. 


NOTE 


- The F attribute is reserved for the basic format file listed in table 4-1. If you 
remove the F attribute from those files, your new disk will not be formatted pro- 
perly. If you assign the F attribute to any other file, that file will not be copied 
by the roa command. 





Table 4-1. Disk Formatting Example 


Type of File 


ISIS-I1 basic format files op Sc1S1S.01R 
= ae Ts ISIS.MAP 
1SIS.TO 
- ASIS.LAB 
"SIS. BAD. 





ISIS-ll basic system files . | 1SIS.BIN 
eens od asis.cur 


| ISIS-lII system command files» |” ATTRIB 
rl Oe cee ea Oe a COPY 

BE gig pe eT 
Free Gs BIRDS cis 


«KK mK OK * >« 


1SIS.BADi is supplied with hard disk systems only 
y SATIRE: Isinvisibie FeFommat s S=System We\Write-protect 


; a Formats 2 a poasic non-system disk. 
(2) Formats a basic system disk. < 
(3) Formats a system disk and copies all other files on the source disk. 
_ {4) Formats a system disk and copies all other files that have the $ attribute set.°* 
(5) Copies any files that do not have the S attribute set. 
(6) Copies all other files that have the S attribute set. 


- 
“ 





ey ey 


s 


suede at 


4g 


Series 11] Operating Instructions 





o 
- 
° 

a 
= 


“Hf you want other files such a 
“command, seco eS 


_ Hard Disk Systems.. The ha 
disk. See example 3 below. 


iDISK—Disk Formatting Command 


The IDISK command formats a new disk for use with ISIS-I1. 


Command Syntax 
IDISK :Fnilabel (switchesl<cr> 


Lge 


where 


Loe 


“os 


‘Fn: refers to the directory of the disk to be formatted. The value n is the 
number of the drive (0-9) where the blank disk is located. 


label is the name to be given to the blank disk. The syntax of label is the same as 
for filename with up to six characters for name and three for extension. Label 
must follow :Fn: with no intervening space or comma, as in :F1:MYDISK. 


switches are one or more of the following: 


S - Formats the new disk as a basic syste disk. If S is not specified, the . 


disk is formatted as a basic non-system disk. 


P Specifies single drive mode. The system prompts for output and 
-* system disks, pausing to display the prompt messages and to allow 
. changing of disks. If source and destination drives are the same, the P 

switch is the default. ; 


FROM n Specifies the disk drive containing the source disk files needed for 
formatting the new disk. The value n is an integer 0-9 for drive 
numbers 0 through 9. If the FROM n switch is not specified, the 
default is to drive 0. If n is not a valid integer 0-9, an error message 
results. For example: .. 


“rFIOIMYDISK, INCORRECTLY SPECIFIED FILE 


Description 


_IDISK copies only the files needed for a basic disk (whether system or non-system). 
_ A basic non-system disk contains only the files needed to format the disk: ISIS.DIR, - 


ISIS.MAP, ISIS.TO, and ISIS.LAB, plus ISIS.BAD if a hard disk. For a basic 


“system disk, IDISK copies two additional files: ISIS.BIN and 1S1S.CL1. 


mmand files copied to the new disk, use the COPY 





* Single Drive Systems. You can use IDISK.on single-drive or multiple-drive disk ° 


systems. On single drive systems, you are prompted to remove the disk and insert the 


‘blank disk. When the formatting is completed, you are prompted to insert the 


original system disk. See example 1." 










- When used with a hard disk, IDISK verifies each sector. If IDISK cannot read a 


sector reserved for an ISIS-II file, the following message is displayed: 
FATAL BAD SPOT AT LOGICAL ADDRESS (ttt, sss),STATUS=nnnn 


where ttt is the Jogical track address (in decimal), sss is the logical sector addres (in 


~ decimal), and nnnn is the hard disk error status (in hexadecimal). 


rd disk platter in drive 0 must be formatted as a system - 


de 
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If the unreadable sector does not correspond to an ISIS-11 file, the following 
message is displayed: 


BAD SPOT AT LOGICAL ADORESS (ttt, sss), STATUS=nnnn 


Since ISIS-II allocates hard disk sectors serially, if no mechanism existed to skip 
over bad hard disk sectors, the remaining sectors would remain unallocated and 
unusable. Instead, ISIS-H checks hard disk sectors for irregularities duyjng 
- FORMAT. and IDISK operations. If a bad sector is encountered, it is allocatet ta 
: ISIS.BAD and hard disk formatting continues. al 


’ 


ht. 


Examples 


1. This example formats a new disk in drive 0 as a basic system disk on a 
single-drive system. IDISK prompts for the new (output) disk and for the system 
disk. IDISK gives the disk the name SYS.V1. To copy other files on the newly 
formatted disk, use the COPY command for single drive systems described later 
in this chapter. , 


ath (DISK F025 YSSW Imes <crD, 
ES SYSTEM DISK 
( LOAD OUTPUT DISK, THEN TYPE (CR) 
LOAD SYSTEM DISK, THEN TYPE (CR) , . 


2. This example formats a new disk in drive 1 as a basic system disk and gives the 
disk the name NSYS.V1. The COPY command copies all other non-format files 
from the disk in drive 0 to the disk in drive 1. 


aL DISKS TALNS YSIS scr> 


SYSTEM DISK 

of COPY Wt et Oi 0 TA EC ES Kcr. 
COPIED :FO:ATTRIB TO :FI:ATTRIB 
COPIED :FO:COPY TO :F1:COPY 
COPIED :FO:OELETE TO :F1:DELETE 


a 

o 

° 
o 


3. This example formats a hard disk platter in drive 0 as a basic system disk and 
Fann ‘copies the basic files needed to format the disk from the system disk in drive 4. 
po To copy other files onto the newly formatted disk, use the COPY command as 
shown in the previous example. 


og Ga DISKS YSIE MDS KES SERON BS Sce>. 
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FORMAT—Disk Formatting Command 


The FORMAT command formats a new disk for use with 1SIS-I] and copies files to 
the new disk. 


To fonhiat a disk on a system with a ‘single flexible disk drive, use the IDISK 
command. se 2st 


Command Syntax | -! 
FORMAT :Fnilabel [switches]<cr> 


where 


‘Fn: refers to the directory of the disk to be formatted. The value n is the - 


_ number of the drive (0-9) where the blank disk is located. 
NOTE 
In versions of ISIS-I! before version 4.0, :Fn: defaulted to :F1: in the 
FORMAT command. This default has been removed. If you have SUB- - 


MIT files that use this default, you must change them. You will receive 
an error message if you try to default to :F1:. 


label is the name to be given to the disk. The syntax of /abel is the same as for 
filename with up to six characters for name and three for extension. Label must 
follow :Fn: with no intervening space or comma, as in :F1:MYDISK. 


switches are one or more of the following, separated with spaces: 
A Copies all files to the specified disk except files (other than ISIS-I] 
system format files) with the format attribute set. If the source disk is 
' asystem disk, the new disk becomes a system disk. 


) Copies the Basic format files and all files with the system attribute set. 
If the.source disk is a system disk, the new disk becomes a system 


disk. (The.S switch functions eiicrenty under FORMAT than it: 


does under IDISK, ) 


FROM n Specifies. ‘the disk “drive containing: the disk. files needed for 


formatting. nis an integer 0-9, for drives 0 through 9. If the FROM n 
switch is not specified, the default is to drive 0. If n is not a valid 
integer 0-9, an error message is displayed. For example: 


rFIO:MYDISK, INCORRECTLY SPECIFIED FILE 


If you specify :FO: and no FROM n utiehy or if you specify :F0: and 
FROMO, the following error message is displayed: ; 


CANNOT FORMAT FROM TARGET DRIVE 


Description 
A disk is formatted as a system or non-system disk depending on the type of source 
disk used and on the switches specified inthe FORMAT com:nand. . 


When a system disk is formatted, FORMAT copies: other files in addition to ithe 
basic format files. 
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When a non-system disk is formatted, FORMAT copies only the basic format files: 
ISIS.DIR, ISIS.MAP, IS1S.T0, and ISIS.LAB, plus ISIS.BAD if a hard disk. 


Hard Disk Systems. The hard disk platter in drive 0 must be formatted as a system 
disk. See example 3. 

: ate 
When. used with a hard disk, FORMAT verifies each sector. If FORMAT canpot 
read a sector reserved for an ISIS-I11 file, the following message is displayed: ° 
; ri 
FATAL BAD SPOT AT LOGICAL ADDRESS (ttt, sss), STATUS=nnnn 


where ttt is the logical track address (in decimal); sss is the logical sector address (in 
decimal); and nnnn is the hard disk error status (in hexadecimal). If the unreadable 
sector does not correspond to an ISI1S-I] file, the following Message is displayed: 


BAD SPOT AT LOGICAL ADDRESS (ttt, sss), STATUS=nnnn 


Since ISIS-I] allocates hard disk sectors serially, if no mechanism existed to skip 

over bad hard disk sectors, the .remaining sectors would remain unallocated. 

Instead, ISIS-I] checks hard disk sectors for irregularities during FORMAT and 

IDISK operations. If a bad sector is encountered, it is allocated to ISIS.BAD and 
hard disk formatting continues. 





Examples 


1. This example creates a duplicate system disk excluding any files that do not have 
the system attribute set. 


a FORMA Ie FAR a5 00SS YS <cr, 


COPYING SYSTEM FILES 
ISt$.T0 a 
ISIS.BIN 
ISIS.CLI 


* 





- SYSTEM. fe eet i eet oe 
es 2. This example formats a basic non-system disk on drive 1, giving it the name eof Be 
LIB.V1. System files are.not. copied. . ~ ae 


ROY sFrPcree 


aoe, SYSTEM ‘DISK 






3. This seule formats: a hard disk j in deve Oasa . system disk; the files with ie 
system or format attribute set are copied from a system disk in drive 4. 


- -BPASTDCLY seu ah ee ot kone 
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FIXMAP—Hard Disk Mapping Command 


- The Fixmap command maps bad sectors on hard disk. 


Command Syntax 
FIXMAP drive<cr> 


where 


drive is the number of the hard disk drive on which the command is to operate; 
drive is an integer value of 0 or 1. 


Description 


The FORMAT and IDISK commands in ISIS-II recognize bad sectors and record ~ 


the numbers of these sectors to prevent their allocation to files. Fatal errors and disk 
errors arising during the HDCOPY procedure can also show that sectors are bad; 
either of the following messages reports that logical track 137, logical sector 106 on 
drive | is bad: 


STATUS=000F 

D=1 T=137 $2106 

DISK ERROR-UNABLE TO WRITE TO DESTINATION DISK ON DRIVE 14 
LOGICAL ADDRESS (137, 106) STATUS=000F 


The FIXMAP command records the presence of bad sectors reported in either form 
illustrated above. There is no corresponding command for flexible disks. 


- When the FIXMAP command is entered, it displays a sign-on message followed by a 
FIXMAP prompt (an asterisk): 


ISIS-I1 MAP FIXER Vx.y 


where xy is the version and release number of the FIXMAP program. 


_ If an earlier malfunction caused damage to a required ISIS-I] format file, the 
folhow: ing message is displayed: eee . 





npn 


“BAD ‘SECTOR count INCONSISTENCY 


If you use FIXMAP to chaiige the} state e (g00d-bad) of any sector, the inconsistency 
is resolved, but the disk remains unreliable. All important files should be copied to 
another disk ang the unreliable disk ref ormatied. 





FIXMAP tes . 
You direct the operation of FIXMAP by entering commands from the following list. 
FIXMAP prompts.with an asterisk whenever it is ready to accept a command. 


Mark disk-address | Change the known state of a sector from good to bad. 


Free disk-address Change the known state of a sector from bad to good. 

List filename List all known bad sectors. - 

Count List the number of known bad sectors. . 
- Record - : Record changes specified by Mark and Free. : 

Quit Exit to ISIS-I] without recording changes. 

Exit Record changes-and exit to ISIS-I1. 


Pacer E. 
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TS Bead Bed WEE We WEEP ELE Se bh ease acess ted 


SAS a nM Roti S, 2 - 2 WEED ESE Ap asi bstda FEILER ELLIS 


A command may be truncated at any point after its first character. For example, M, 
MA, or MAR may be used to stand for Mark. 


When a command calls for a disk address, that address should have the form: 


track, sector({T] 


where - - ; xs 


‘ track is a number from 0 to 199 that specifies the logical track address confain- 
: ing the bad sector. 


a ; sector is a number from 1 to 144 that specifies the logical sector address of the 
bad sector within the track. 


Tisan optional switch indicating that a group of 36 sectors should be processed. 


The T switch is appropriate if the STATUS reported in the error message was 0001, 
QO0A, or O00E. Gre ised 7 for a description of status.) 


& | : : | if the T switch is present, the sector number specifies a group of 36 sectors on track: 
Of sector is in the range 1-36, that group of sectors is processed. 
If sector is in the range 37-72, that group of sectors is processed. 
if sector is in the range 23. 108, that group of sectors is processed. 
If sector is in the range 109-144, that group of sectors is processed. 
‘Track ana sector numbers,. ‘and the T switch, if present, should be separated by 


“... spaces. The track and sector numbers should be those reported in the error message 
ee that eget ied the. bad. sector. BEES 





en Mark Gonmand | : 
The Mark command changes tke known state of a sector from good to bad. 










The syntax of thes Mark command i is: 








KARK disk-a Jdress<cr> 





sector address of the sector to be marked as bad. 





ie if the Tsw witch i is present, a group of 36 sectors is marked as bad. A sector known to 
_ be bad is not allocated to sae file. : 





If the sector specifi i in athe Mark command: is not associated with an existing file, . 
= ane sector is marked as oat as ane qT sw itch i is not present, the ayn displays: . 





“ SECTOR MARKED. 


If the T satchel is present, no message appears when a single sector is marked; 
~ instead, when all 36 sectors have been processed, the system displays the message: 


weary 


TRACK PROCESSED 
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6.8 bb best 


- 2. Givethecommand ° 


_ FreéCommand . 
- The Free command changes the known state of a sector from bad to good. 


If the sector belongs to an existing file, it cannot be marked as bad. Under any of the 
following conditions, the sector is not marked: 


If the sector belongs to one of the required 1S1S-II format files, the system displays: 
(track, sector) REQUIRED BY ISIS-11 | , 


io 
The system will be unreliable when the questionable disk is in use. You should For 
mat a new hard disk and copy your program and data files onto it. i 


If the sector is already known to be bad, marking the sector is redundant. The 
system displays: : 


(track, sector) ALREADY MARKED 
If the.sector belongs toa file other than a required format file, the system displays: 
(track,sector) IN USE 


If you know the name of the file, exit to ISIS-II and delete the file; then use 
FIXMAP to mark the bad sector. If you do not know the name of the file, follow 


this procedure: 


1. Exitto ISIS-Il, using either the Quit or the Exit command (described below). 


COPY Sensi a 0 etn So e< 


where :Fn:*.* refers to the disk containing the source files, and the second :Fn: 
_refers to another hard disk. The Q switch causes the system to query before 
copying each file. (See the description of COPY.) 
3a. If the copy is successful, disk :Fn: contains a usable copy of the bad disk. Use 
- FIXMAP to get a list of bad sectors on the bad disk; then use IDISK or 
- FORMAT to reformat that disk, and use FIXMAP to mark any bad sectors 
_ missed by the formatting command. 





3b. Jf an error occurs while the disk is being copied, write down the last filename . 
displayed by Copy, as well as.the track and sector numbers appearing in the — 
~ error message. Use the Delete command to delete the bad file from the bad disk, 


then use FIXMAP to mark thebad sector. If an error occurs and prevents you 


© from deleting the file, repeat step 2. The file you attempted to delete will not be 


copied to the new disk. Repeat step 3a. = 


‘Example de: The following example illustrates the use of the Mark command: 


EP NARKer 7aB3<cr> ie eeeaget 





- SECTOR MARKED 
Pe HARK $2 (M55 SCT Rees 


(27,83) ALREADY MARKED. 





The syntax of the Free command is: 


FREE disk-address <cer> 


aeerpoat 


where 


disk-address is the track-and-sector address of the sector to be freed for 
allocation. 


ISIS-1] Console Commands 


4818-1] Console Commands Series 11] Operating Instructions 


If the T switch is present, a group of 36 sectors is freed. You might use this com- 
mand if you had marked a sector by mistake. 


if the sector specified in the Free command is known to be bad, it is freed for alloca- 
tion. If the T switch is not present, the system displays: 


SECTOR FREED a: 
° If the T switch is present, no message appears when a single sector is freed; instéad, 
4 when all 36 sectors have been processed, the system displays the message: 
i. TRACK PROCESSED 
Under either of the following conditions, the sector is not freed: 
If a sector is already free for.allocation, freeing the sector is redundant. The system 
& oe (track, sector) ALREADY FREE 
’ If the sector is not free because it is in use by a file, the system displays: 
(track, sector) NOT A BAD SECTOR 
There is no reason to free a good sector that is part of an existing file. 
_ Example 2: The following example illustrates the use of the Free command. Note 
-.... that 85 T and 8 10 T identify the same group of 36 sectors, i.e., sectors 1-36 on 
oe? rack 8.000 oe oe ee 
EES rersy 
- itgme: SECTOR FREED rice e sen: 










SMARKES €5 SIACT> fe 


TRACK PROCESSED 
aU FREEGS @2 OKCED 
SECTOR. FREED 
FREESE te 0 icc rp! 
(8,10): ALREADY. FREE 
_ TRACK PROCESSED 









List Command - — Se 
"The List command writes a list of all known bad sectors on the named file. 





The syntax of the List command is: 


“ust Cfifenemelcer. a 








ae where _ 


[filename] is an optional parameter specifying the listing file. 


pt ab bat 


The listing file may be either an output device or a disk file. It may not reside on the 
disk being fixed. If no filename is given, the list is printed on the console. 


ry 
hay 


Bx) 


The format of the output is one sector per line, with track and sector numibers 
separated by a comma. The list includes all sectors marked by FIXMAP, as well as 
bad sectors found by IDISK and Format. 
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bo ay bye? 





If there are no known bad sectors, the system displays: 


NO BAD SECTORS 


If output is directed to a device other than the console, the following message is 
displayed after the list is written to the device: 


a 


LIST WRITTEN 


a aes 
rom, 


If the named file resides on the disk being fixed, the system displays: 


CANNOT LIST TO TARGET DRIVE 


Example 3: The following example illustrates the use of the List command. The list 
is written first to the console, then to a disk file. 


gLiSiccro| 
180,63 
182,115 
182,116 
182,117 


Mista ISKk=Fiixcrol mk , 


LIST WRITTEN 


Count Command : 
The Count command reports the number of known bad sectors on the disk. 


The syntax of the Count command is: at : . é 


cae -COUNT<er> 





: The command displays the f Following message on the console: 





ce BAD SECTORS 





XXXXX isa decimal aGaber: the auiiber of known ee sectors on the disk. A sec-_- 
tor that has. hot been marked, ‘or a sector that has been marked and then freed, 


4820417 
NS COUNT& Ce mee 
& BAD SECTORS 


tadap ge 
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Record Command. 
The Record command records the changes specified by Mark and Free. 


The syntax of the Record command is: 


RECORD<cr> if 
When this command is entered, changes specified by Mark and Free are eeerieica 
: the disk. 2 
a 


If you intend to use the Exit command to leave the FIXMAP program, the Record 
command is unnecessary. (Exit is described below.) If you intend to use the Quit 
command, the Record command js required; otherwise, none of the marking and 
freeing specified during the work session—or since the last Record command—will 
actually take effect. 


When the recording is complete, the system displays: 


fs. ' CHANGES RECORDED 
If no sector has been marked or freed during the work session—or since the last 
Record command—the system displays: 


NO CHANGES 


.Example 5: The following example illustrates the use of the Record command. 


BRECORDScy>| 
CHANGES RECORDED 
gRECORDSe7>) 

NO CHANGES 


Quit Command . 
The Quit command stops the operation of FIXMAP and returns to ISIS-I. 


ot The syntax of the Quit command is: 


QUIT<cr> 


If the Record command has not been given, changes specified by Mark and Free are 
- not recorded on the disk. 


Example 6: The following example illustrates the use of the Quit command. Note 
that the freeing of sector 12, 86 is not recorded on the disk; therefore, upon reentry 
to FIXMAP, that sector is still known as bad. ; 


WEE FREER ESO SCY 
~ SECTOR FREED 


wit 
ar 


= “4 ee 


: ISIS-I] MAP FIXER Vx.y 


pe bab bey 


A 
if 
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fivenss 


he & oe bay 


COUN Terx>, 


8 BAD SECT 


ORS 


A RECORDScy> 


NO CHANGES 


FIXMA PR KCr>) 
ISIS-11 KAP FIXER V1.0 


FREE G2 7087235 @ikrr> 


(170,109) 
(170,110) 
(170,111) 
(170,112) 
(170,121) 
(170,122) 
(170,123) 
(170,124) 
(170,125) 
(170,126). 


_ (170,127) 


(170,128) 
(170,129) 
(170,130) 
(170,131) 
(170,132) 
(170,133) 
(170,134) 


170,135) 


(170,136) 
(170,137). 
(170,138) 
(470,139) 
(170,140) 
(170,141) 
(170,142) 
(170,143) 
(170,144) 
TRACK PROC 
SHARKSIED 
SECTOR MAR 


* 
170, 113 


ALREADY 
ALREADY 
ALREADY 
ALREADY 
ALREADY 
ALREADY 


ALREADY” 


ALREADY 
ALREADY 


ALREADY. 


ALREADY 
ALREADY 
ALREADY 
ALREADY 
ALREADY 
ALREADY 
ALREADY 
ALREADY 
ALREADY 
ALREADY 
ALREADY 
ALREADY 
ALREADY 
ALREADY 
ALREADY 


ALREADY 


ALREADY 
ALREADY 
ESSED 
fen trct> 
KED 


FREE 
FREE 
FREE 
FREE 
FREE. 
FREE 
FREE 
FREE 
FREE 
FREE 
FREE 
FREE 
FREE 
FREE 
FREE 
FREE 
FREE 
FREE 


“FREE 


FREE 
FREE 
FREE 
FREE 
FREE 
FREE 
FREE 
FREE 
FREE 
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Example 8: The following example illustrates a typical’ work’ session with 
FIXMAP. You invoke the command and begin by getting a list of all bad sectors on 
the target drive (drive 1, as indicated in the FIXMAP command). The Count com- 
mand reports that there are eight bad sectors, and the Record command shows that 
no sectors have been marked or freed during this work session. You free the last 36 
sectors on the track containing track 170, sector 113; all sectors except the efght 
known bad sectors are already reported to be free. You mark track 170, sector 113%as 
a bad sector, and again list and count the number of bad sectors. This time, :the 
Record command reports that changes have been made. You free the remaining bad 
sector,-list again, and return to ISIS-II. 


weep oat 








wy ye ipe! 
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J COUNTKcR> 
{ BAO SECTOR 


ZRECORD SCE: 


CHANGES RECORDED 


1 FREEGS 70S <cre.- 


SECTOR FREED 


ERIS 3 3 
NO BAD SECTORS a 
a * ame 
+ CHANGES RECORDED ; 
File Control Commands 
fz, The commands described in this section are: 
= DIR Lists the entries in the disk directory 
COPY Copies files from one device to another 
HOCOPY © Copies files from one hard disk to another 
DELETE Erases filenames from the disk directory 
RENAME Changes the name of disk files 
ATTRIB Changes or displays the attributes of a disk file 


using a wild card construct. Either of two special wild card characters can replace 
some or all of the characters in a name or extension. The wild card characters mean 
match anything when the system searches a directory for a filename. 


The two wild card characters are: 
° Anasterisk (*) to specify a wild card match to any number of characters. 
cS @ A question mark (2) to specify a wild card match to single character. 


The asterisk specifies a wild card match to any name and/or any extension in the . 
directory. For example: ; 


ABC.*—means match any filename with the name ABC and any or no 
extension. 


* PLM—means match any filename with the extension .PLM, such as A.PLM 
or MYPROG.PLM. 


",  ". *,*_-means match all filenames in the directory. 


The asterisk can also specify a wild card match for the remainder of the name or 
extension except for the initial character. For example: 


bs ob bal 


AB*.HEX—means match any filename with AB as the first two charactess of 
. the name and HEX as the extension. This example would match: ABC.HEX, 
ABXYZ.HEX, AB.HEX. : 


*B.HEX is illegal, since * must follow the initial character. 
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Each question mark specifies a single character for a wild card match. For example: 


A?B.HEX—means match any filename with A and B as the first and third 
characters of a three-character name and HEX as the extension. This example 
would match: ACB.HEX, AXB.HEX, AMB.HEX. 


to 
A??,.*—means match any filename with A as first character of a three-charaéter 
name and any extension. re 
re! 


:device: ennet include a wild card character. 


4 
; Wild card constructs enable you to specify multiple filenames with a single reference 
when using the DIR, ATTRIB, DELETE, and COPY commands. For example, you 
can copy multiple rough draft files to an output device by specifying: 
eCOPYSCHAP2Z 2D Fiat 0 a4 P-=Kcr> 
“- DIR—Disk Directory Listing 
The DIR command lists the contents of a specific disk directory. 
Command Syntax 
DIR CFOR filenamel(TO listfilell€switchesl<cr>. 
The positions of these fields are not fixed. 
where 
filename is the file (or group of files specified with the wild card construction) . 
whose directory entry is to be listed. If FOR filename is omitted, the entire 
directory is listed. If filename is not a wild card name (that is, does not contain * _ 
or 7), it is listed even if it has the invisible attribute. a 
listfile is the name of the file or output device such as :TO: or :HP: to contain | ‘ 
aa the directory HoUns If TO listfile is omitted; the listing is displayed on the - 
screen. 


¥ switches are € one or more of the following, separated by spaces: 





: 0.9 ‘Lists the divectory: of the disk in :FQ:, :Fl:, :F2:, ... :F9:. If 
= " omitted, the directory of the disk in drive 0 is listed. If more than 
cone drive number is specified, only the rightmost one has effect. 
~The drive number also overrides any device specification in Pree 
“Hlename. 


I Lists all files, including files with the invisible attribute set. If 
omitted, only files with the invisible attribute not set are listed. 


68 ae bay 


Gives fast output, listing only filenames. 


a 3 O Prints the directory in a single column format. The default is 
double column format. z 
Z Prints the eee of sectors presently used on the specified disk as 
a fraction of the number of available sectors. 
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P Specifies single drive mode. After loading the command, the 
system pauses with the message: 


LOAD SOURCE DISK, TYPE (CR) 


After the source disk is loaded and the RETURN key is pressed, the 
requested directory is output to the specified device. The a 
then requests that the system disk be replaced: 


+ ’ LOAD SYSTEM DISK, TYPE (CR) 


Description 


The DIR default: is the directory output in two columns with the 
following headings: 
DIRECTORY OF name.ext 











NAME EXT _BLKS LENGTH ATTR NAME = .EXT BLKS LENGTH ATTR 
= - where 
name.ext is the label of the disk volume that is assigned by the 
FORMAT or IDISK command. It has the same syntax as a 
filename. Each item listed by DIR is explained in the section ‘‘Disk 
Directory’? in Chapter 3. The directory listing shows the number of 
blocks in use and the total number of blocks within the disk (2002, 
4004, or 28800). 
Examples 
1. The following example lists two files of a flexible disk on a single density 
system. The system es which have the invisible attribute set, are not listed. 
DIRECTORY C OF :Fo: ISODAB.SYS_ 
NAME EXT _BLKS_ LENGTHATTR NAME EXT BLKS LENGTH ATTR 
aa. PROGA . .-HEX 75. 8283 —~=~C<éN SUMS $1 6357 
es Soe ao — ae 
a , 936/2002BLOCKS USED. = 
om The following is the same as example 1 except a fast listing is requested: 
DIRECTORY OF \ FOSISOOAB.SYS 
PROGA.HEX sees 
936/2002 BLOCKS USED © 
| 3. The following exampl requests a directory listing of all format files be s sent to 
the line printer. The forimat files have the inv isible. attribute, and ISIS.* is a wild 
- . card filename,so the I switch must be specified. 
ae es DIR GOR SE S75 2097 eee Kcr. 
Cs 4, ‘single-column fast directory listing of the double-density nes disk in drive 
2 1 is requested by the following command: 


= = PRS 
DIRECTORY OF DISK sF1:ISI.V10 
TYPE.M80 
TYPE.HEX 
TYPE 
1337/4004 BLOCKS USED 


weeapoge 
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COPY—Copy a File 


The COPY command copies files from one device to another. 


~Command Syntax . 
coPy C: Fn: linfile ae ee Ort 


Pa 
sdevice: | tswitches]<cip 
. rt 


where 


. vate isa a file (or group of files when using the wild card construct) to be copied. 
The copy does not affect the contents of infile. If more than one infile is 
specified, they are concatenated in the order specified. When concatenating 
files, specify the full name and extension of each file. The wild card construct 
may not be used when concatenating files. 


outfile is a file to be created or recreated. If :Fn: is not specified, :FO: is 
assumed. outfile must include the extension, if any. If ourfile is not specified, 
:Fn: must be specified. : . 


:device: is an output device, such as :LP:, :TO:, :HP:, or :CO: 


‘switches are one or more of the following: 


Ny Copies files with the system attribute set. For example, the 
command: ; 





" copies only files with the system attribute from drive 0 to drive 1. 
N Copies files without the system or format attribute set. 


Specifies single drive mode. When files are to be copied between 
two disks on the same drive, the system prompts for disk swaps 
with the following messages: 


LOAD SOURCE DISK, THEN TYPE (CR) 
LOAD OUTPUT DISK, THEN TYPE (CR) 
“LOAD SYSTEM DISK, THEN TYPE (CR) 


Q  — Specifies the query mode. The system displays the following 
‘message before a copy is performed: COPY infile TO outfile? A 
yes or y response causes the copy to be performed. Any other 
response causes the copy not to be performed. 


ron | Creates outfile with the attributes set from the inf ile. For example, 
if file XYZ with the I attribute set is copied.to the file ABC, the 
final file ABC will have the I attribute set. 


If this switch is not specified, outfile is created with all attributes 
ee reset (off). This switch does not copy the format (F) attribute. 


>B Deletes an existing file without displaying the “ALREADY 
EXISTS” prompt. The existing file is deleted and recreated with 

- hew data. 
U Opens ourfile for update instead of deleting it. The “ALREADY 


EXISTS” message is suppressed. The length i is not changed unless 
the copy causes an increase in the size of the file. 


if U and B are both specified, the U function is performed. 


Operating Instructions 


Description 


When copying from one device to another, the destination can be disk files Or 
physical devices. The copy must be made from an input device to an output device. 
For example, you ean copy from the reader to the punch but not from the punch to 
the reader. 


If outfile is an existing disk file and is not write protected, the following messalf is 
displayed: . ; 4 


rl outtile FILE ALREADY EXISTS 
: DELETE? ; 


lf you respond to the message with yes Or ¥ (followed by a carriage return), COPY 
deletes the existing file before making the copy. No action is performed if you give 
any other response. ; 


if outfile is write protected, then the following message is output: 


ES outfile WRITE PROTECTED 


Single Drive Mode. The COPY command supports single disk drive systems. You 
can copy files from one disk to another using only 4 single drive. The command 
prompts for the source, output, and system disks as it needs them. If you specify a 
copy ona drive with no change in filename, the command assumes you want to swap 
disks and prompts for the swaps. For example, the command 


he CORYAAB CerOmABLescr= 


results in prompts to swap disks in drive 0. But the commands 


reascercs-to=asC<ct> al ee oe foes 


and 


acOPYSABC MAD EFsCTO 


oe do not result in prompts for disk swapping. You can also copy files between dif- 
ferent disks on the same drive by specifying the P (pause) switch in the command. 


“wild Card Designations. When you use wild card designations, the following rules . 
apply: 
e Every position in the infile that contains an * must have 4 corresponding * in the 
outfile name. 
e Every position in the infile name that contains 2 2? must have corresponding 2 or 
-* in the outfile name. : ; 
1 e@ The wild card characters cannot be used in device designations (you cannot 
- specify :F* D2 


gf at ba; 


To selectively COPY files with the wild card construct, use the query mode. For 
: example: 


mcO PYSEEDZCHAPZEO LAD eracenccy 


The sysiem then displays the query message before copying each file. 


wed se oat 
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is the same as specifying: 


Copying to Another Disk. The COPY command provides a special case for conve- 
nience when copying disk files to a different disk.If ourfile is to have the same name 
as infile, you need not enter outfile. For example: 


a COPYSESASABCEXYZ01 0 OF 22K crD 


Secenhie 


a COPYS-FARABCSXNY 29 OS Fe-ABLEKYZ<cr> 


This form can be used with wild card designations in infile: 


COPY a Fase ees Olek 


At the end of the listing of files that were copied the following message is displayed 
if write-protected files have been encountered: 


WRITE PROTECTED FILE ENCOUNTERED 


Possible Error Conditions 


If you use a wild card designation when concatenating files, an error message is 
displayed: 


ee COPYSA EH COAT ORD Ser 


WILD CARD DELIMITERS DURING CONCATENATE 


_ When you use the concatenate operation, ourfile must not have the same name as 


infile. 1f it does, the following error message results: 

a CO PYSA SS OSG Sree 

SOURCE FILE EQUALS OUTPUT FILE ERROR 
If the rules governing wild card designations are not followed, the following error 
message is displayed: 


i COPYMAR Ceti 0SDKrY> 


FILE MASK ERROR 


Examples 


1. This example copies three files to one, overwriting its contents: 


a COPYMLHAPAINCHAPZCALHAPS £0 &BOOKSce> 
2FO:BOOK FILE ALREADY EXISTS, © 
DELETE? : 

-APPENDED :FO:CHAP1 TO :F0:BOOK 
APPENDED :FO:CHAP2 TO :F0:BOOK 
APPENDED :FO:CHAP3 TO :FO0:BOOK 


2. Example 1 could have been done in the following way: 


COPA MD HAPZADHAPS ELLOS 

APPENDED-:FO:CKAP1 TO :F0:800K 
APPENDED :FO;CHAP2 TO :F0:800K 
APPENDED :FO:CHAPS TO :FO:800K 
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. This example lists a file‘on the line printer: 


SCOPYMBOOKMS DLP KCI 
COPIED :FO:BOOK TO :LP: 


This example displays a file on the console output device: 


a COPYSCHAPI St 0 Me LO=KcI> 


(text of CHAP1) ie 
COPIED :FO:CHAP1 TO :CO: 4 


This example copies a file from the disk in drive 0 to the disk in drive 1: rf 


a COPYSPROA SID Me FACNEWUPRE SE Cer: 


COPIED s:FO:PROGA TO :FI:NEWPRG 


This example copies system files from one disk to another on drive 0: 






LOAD SOURCE DISK, THEN TYPE (CR) 
LOAD OUTPUT DISK, THEN TYPE (CR) 
COPIED :FO:ASM80 TO FO: ASM80 


o 


LOAD SYSTEM DISK, THEN TYPE (CR). 

If the files to be copied are quite large (exceeding the size of the available RAM) | 
the LOAD SOURCE and LOAD OUTPUT messages will be displayed more 
than once. As each file is copied, a COPIED message is displayed. After the last 
file is copied, the LOAD SYSTEM message is displayed. 


These examples show valid uses of wild card names with the COPY command: 
COPY a t12*2s 0 0 FP ere. (copy all files except those 
; with the FORMAT 
attribute) 


a CORYS FAS A272 Ce OM ENLDI“ZEScIO 


ERS ee (copy all non-system and 


non-format files) 


a COPY: EEE REET Ty SFO sPCPIKcr. 


o HDCOPY—Copy Hard Disk Tracks 


The HDCOPY command copies ‘the contents of one hard disk to another hard disk 
on a track-by-track basis. The data transformed are verified during reading of the 
data into memory. BpcOrs formats the designation disk before writing data to it. 


Command ender 


indrive TO outdrivel | 
“HOCOPY. { ; BACKUP <er> 
where 7 


indrive is the number of the drive containing the source hard disk. 


v8 abbas 


outdrive is the number of the drive containing the destination hard disk. 


Both drive nunibers must be 0 or 1, but both cannot be the same drive iieabers 
Both drives must be a hard disk drive. z 


BACKUP is a switch that can be used to backup a removable hard disk platter. 
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Description — 


If you specify BACKUP, the following actions occur: 
e The contents of the disk in drive 1 are copied to the disk in drive 0. 


®  JSIS-I] prompts for the backup disk to be placed in drive 1. 

© The contents of the disk in drive 0 are copied to the disk in drive 1. 

®  1S1S-I] prompts for a system disk to be placed in drive 1. id 

@ Thecontents of the disk in drive 1 are copied to the disk in drive 0. + 
7 If a disk error is detected while reading from the source hard disk, the folding 
4 message appears on the console device, and a sector of OFFH is written to the 


destination disk: 


DISK ERROR-UNABLE TO READ FROM SOURCE DISK ON DRIVE M 
LOGICAL ADORESS (ttt, sss), STATUS = nnnn 


If an error is detected when reading from or writing to the destination disk, the 
following message appears on the console device: 


& DISK ERROR-UNABLE TO WRITE TO DESTINATION DISK ON DRIVE N 
: LOGICAL ADDRESS (ttt, sss), STATUS = nnn 


. In both cases, processing continues. You must decide whether or not to use the 
destination disk or to attempt to make a new copy (see FIXMAP command). 


In these error messages, ttt is the logical track address (in decimal); sss is the logical 


sector address (in decimal); and nnnn is the hard disk error status (in hexadecimal) 
as described in Chapter 7. 


As each track is copied to the destination disk, a T is printed on the console device. 
If no errors have been detected during a copy operation, the following message is 
displayed: 

VERIFICATION OK- 


If errors have been detected, the following message is displayed: 


BAD SECTORS ENCOUNTERED 








ed 


Possible Error Conditions 


The source and destination drives cannot be the same drive number, or a fatal error 
results, and an error message is displayed: 


“ SPECIFIED DRIVES NOT HARD DISK 


b- 8 ob oe 


* 


web ap ae 
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Exit Command 
The Exit command records changes and returns to 1SIS-II. 


The syntax of the Exit command is: 


EXIT<cr> 


The Exit command is equivalent to the Record command followed by the Quit:zom 
mand: changes specified by Mark and Free are recorded on the disk, and co ‘zo 
returns to ISIS-I1. rt 


’ 


Example 7: The following example illustrates the use of the Exit command. (Com- 
pare this example with example 6, above.) 


FREES 2EB6<cr> 
SECTOR FREED 


* 
CHANGES. RECORDED 


tI XMAPAX CT 
ISIS-I1 MAP FIXER Vx. y 


itSit<cr> 


NO BAD SECTORS 


FIXMAP Error Conditions 


The following errors cause immediate termination of FIXMAP and a return to ISIS- 
Il. If execution terminates as a result of one of these errors, work done since the last 
Record command is not recorded on the disk. 


If no hard disk is present, the system displays: 
USE ON HARD DISK SYSTEM ONLY 


If no drive number is given in the FIXMAP command, or if an illegal switch is pre- 
sent, the system displays: —.- : 


INVALID SYNTAX. 


If this message appears in response to a command within FIXMAP, it means that 
sd command was typed incorrectly, and it does not terminate the session. 


lf the specified drive number i is greater than 3, the system display S: 
' DRIVE NUMBER OUT OF RANGE 


(In the maximum configuration of the system, the hard disk drives are numbered 0 
and 1.) 


___If the disk does not exist in the system, is not on-line, or is not properly connected, 
- the systern displays: 


ERROR 30 USER PC xxxx 


where 


wotan iat 


Xxxx Is a Hexadecimal] number. 
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Examples: 


i 


A sample HDCOPY command: 
BHDCOPYAi MOS Scr. 
LOAD DISK(S), THEN TYPE (oR) 


DRIVE 1 DISK NAME MYDISK.123 IS SOURCE DISK 
DRIVE O DISK WILL BE OVER-WRITTEN 
OK TO CONTINUE? 


Lee. 


TTTTITTTITITTVETTTTTTTT ITT TTT TTT TTT TTT TTT TTT TIT ITT IT TTTT TTT TT TT TTT TTT 
TTTTTTTTTTTTTTTTITTTTTT TTT TTTTITTTTTTTTTTTTTTTTITTITTITITTTTITTTTTTTITT 
TTTVTTTTTTTTTTITITTTTTTTTTTTTTTTTITTTT TTT ITTT TTT TTT TI TTT IIIT 

DRIVE 1 DISK NAME MYDISK.123 COPIED TO ORIVE 0 
VERIFICATION QK 


HARD DISK COPY COMPLETED 


A sample HDCOPY command with the BACKUP switch: 
PYDCOPYSSACKUPSCT> 
LOAD DISK IN DRIVE 1, THEN TYPE (CR) 


DRIVE 1 DISK NAME MYDISK.123 IS SOURCE DISK 
DRIVE 0 DISK WILL BE OVER- WRITTEN 
OK TO CONTINUE? 


yaccr>! 


TTTTTUTTTTTTTTTT TTT TT TTT TT TTT TTT TTT TILT TT TTT TTT TTT TTT TT TTT TT TTT TTT 
TTTTTTTTTTTTTTTTTTTTTTTTTTTTT TTT TTT TTT TTT TTT IT TTT TTT TT TTT TIT TTT TT Tritt 
TITTTTTTITITTTTTTTITTTITTTTTITITTTITITTTTT TIT TTT TIT TTT TT ITT 
DRIVE 1 DISK NAME MYDISK.123 COPIED TO DRIVE 0 


LOAD BACKUP DISK IN DRIVE 1, THEN TYPE (CR) 


DRIVE 0 DISK NAME MYDISK.123 IS SOURCE DISK 
DRIVE 1 DISK WILL BE OVER-WRITTEN 
OK TO CONTINUE? . 


TITTTTTTTTTTTTTTTTTTTITTTTTTTTTTTTTT TTT TTT TTT TIT TTT TIT TTT TTT ITTF ITT TTT 
TITTTTTTTTTTTTTTTTT TIT TTT TTT TTT TTT TTT TTT TT TTT TTT TTT TT TTT TT TTT TTT TTT ITT 
TTVTTTTITTTTTITTTTTTTT TTT TTT TT TT TTT TTT TTT TT TTT TTT TTT TTT TIT TT 

DRIVE 0 DISK NAME MYDISK.123 COPIED TO ORIVE 1 : ' 


LOAD SYSTEM DISK IN ORIVE 1, THEN TYPE (CR) as 


DRIVE 1 DISK NAME ISOOAT.SYS IS SOURCE DISK vk 
ORIVE O DISK WILL BE OVER-WRITTEN 
OK TO CONTINUE? 


TETTTITTTTTTTITITTTTTTTTTTTTTTTTTTTTITTTTT TTT TTT TT TTT TTT TTT TTT TTT TTT TT 
TUTTTTTTTTTTTTTTTTTTTTTTTTTTTTTT TTT TTT TTT TTT TTT TTT TTT TT TTT TTT TTT i Tri 
TUTTTTTTTTTTTTTTTTTTTTITTITTTTTTTTITTT TIT TTT TT ITTV TTT TTT ITT 
DRIVE 1 DISK NAME ISOOAT.SYS COPIED TO ORIVE 0 


VERIFICATION OK 


HARD DISK COPY COMPLETED 


weeegioat 
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DELETE—Delete a Disk File 


The DELETE command deletes specified directory entries. 


Command Syntax 
DELETE (:Ffn:lfilename [Q] [, . . . [@Q]] [P}<cr> 


ae eae 


where 


filename is the name of a file to be deleted. The wild card construction can be 
used to delete a group of files. 


Q Specifies the query mode. The system displays the following message 
before each file is deleted: filename, DELETE? A yes or y response 
causes the deletion. Any other response causes the deletion not to be 
performed. 


ES P Specifies single drive mode. ine system displays prompt messages for 
disk swaps. 


Description 


This command effectively removes the specified file or group of files from a disk, 
making the space it occupied available to ISIS-II for reassignment. A file with the 
write-protect or format attribute set cannot be deleted. 


If filename is a file with neither the write-protect nor format attribute set, the file is 
deleted and a confirming message is sent to the console. 


If filename does not exist, the following message is sent to the console where 
filename is that specified in the DELETE command: 


filename, NO SUCH FILE 


. : Jf the file cannot be deleted because it has the write-protect or format attributes set, 
ae the following message is sent to the console. 


filename, WRITE PROTECTED 


\ 


Query Mode. When you use the Q ss ch, the system displays the query message 
before deleting each file. . 


The query mode allows you to selectively delete files when using the wild card con- 
struct. For example: : 


SE EVES £ eens SH APs ame cor 


The system then displays the query message for each file that matches the wild card 
construct. ; ; 


at abbey 


Single Drive Mode. If you need to swap disks to delete files, sarite the P (pause) 
switch with the command. Belore the deletion is performed, the system displays: 


LOAD SOURCE DISK, THEN TYPE (CR) 
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When the deletion is completed, the following message is displaved: 


Examples: 


tFa: filename, DELETED 
LOAD SYSTEM DISK, THEN TYPE (CR) 


Led 


This example deletes three files. 


OELETESCHAP2Z Nt Krr> 
sFOSCHAPT.TXT, DELETED 
sFOSCHAP2.LST, DELETED 
sFOSCHAP3.SRC, DELETED 


This example shows an attempt to delete a write-protected file. 


SJELETESPROGAPASN<cr> 


tFO:PROGA.ASM, WRITE PROTECTED 


This example shows the deletion of a file using the P switch. 


BOELETESPROGH SASH &P<cr> 


LOAD SOURCE DISK, THEN TYPE (CR) - 
sFO:PROGB.ASM, DELETED 
LOAD SYSTEM DISK, THEN TYPE (CR) 


-RENAME—Rename a Disk File 


The RENAME command changes the name of a disk file. Only the directory is 
affected. 


Command Syntax 


RENAME [sFniloldname TO £: Fn: ]newname<cr> 


where. 


:Fn: must be the same for both o/dname and newname. 


oldname is the name of an existing file whose write-protect or format attribute 
is not set. oldname follows :Fn: with no intervening space, as in :F2:MYPROG. 


newname is the new name to be assigned to o/dname. newname follows :Fn: 
with no snlesvening space, as in :F2:PROGI. 


Description 


When you enter the command to change the name of an existing file to a new name 
that does not already exist, the system makes the change in the directory. 


However, if another file with the new name already exists, the following message is 
displayed: 


newname, ALREADY EXISTS, pete ies 


Hee ep yt 


if the existing file j is to be deleted, enter a Y or y followed by a carriage return. 
RENAME will Grice the existing file and change the name of oldname in the 
directory. 
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a re 


where 


If the existing file to be deleted is write-protected or if you enter any characier other 
than Y or y, the existing file is not deleted and the file to be renamed is not renamed. 


NOTE 
RENAME cannot be used on nonsystem disks on a single drive system. To 
change the name of a nonsystem disk file with only a single drive, use the 
COPY command to copy the file to a file with the new name, then delete the 
old file with the DELETE command. : : 
Possible Error Conditions 
lf oldname is a nonexistent file, an error occurs. 


If the :Fn: part of oldname does not match the :Fn: part of newname, an error 
occurs. 


Examples 
1. The name of a file on drive 0 i is changed from CHAP! to CHAP.ONE: 


Be RENAMESCHAP 12 &i OSCHAPZONE<cr> 


2. Anattempt is made to rename a write-protected file: 


BRENAMESINEMPRGASX TS OSPROGANIX gc 
NEWPRG.TXT, WRITE PROTECTED eo re 


- 


3. Inthis example, the new name is the name of an existing file. 


RENAME MEX ISBAK ST OMEXTSU LD cee: 
TEXT.OLD, ALREADY EXISTS, DELETE? [FREE 


ATTRIB—Change/Display Disk File Attributes 


The ATTRIB command changes: and/or ee the specified attributes of a disk 
file.. 


Contmand Syntax . 
ATYRIB C3 Poe lfilename tattriblistl. PuISe DP. 





filenam is a disk file whose attributes are to be changed. The wild card con- 
: struction can nbs used to change and/or display the attributes of a zTOuP of files. 


attriblist is one or more of the followi ing: 


Worl Resets (10) or sets (11) the invisible attribute. When set, the file 
is not listed by the DIR command unless the | switch is 
specified in the DIR command. - 

WO or WI “Resets (WO) or sets (WI) the write-protect atiribute. When set, 

"the file cannot be opened for output or update, and cannot be 
deleted or renamed. 
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FO or F] Resets (FO) or sets (F1) the format attribute. Removal of the 
format attribute from system files will cause improper format- 
ting of new system disks. This attribute is reserved for specific 
system files and should not be assigned to any other file. 
Assigning this attribute to any other file will cause that file not 
to be copied by the FORMAT command. 


=e 
$0 or S1 Resets (SO) or sets (S1) the system attribute. When set, thé file 
is copied to the disk being formatted by the FORMAT com- 
mand when the S switch is used. This file is also copied by the 
a os COPY command when the S switch and wild card notation are 
: used. 


If two values of the same attribute are specified, for example both ]0 and 1], 
the one rightmost in the command takes precedence. 


Q Specifies query mode operation. 


Description 


When you specify the Q switch, ATTRIB displays the following messages before 
changing the attributes of a file: 


filename, MODIFY ATTRIBUTES? 
Type a Y or y if you want the file attributes modified. Any other response causes 
ATTRIB to leave the attributes unchanged for the specified file and to go on to the 
next file in the group. 
If a nonexistent disk a ile is specified, ATTRIB displays 

filename, NO SUCH FILE 
If a non-disk file is specified, ATTRIB displays: 


filename, NON-DISK DEVICE 


ce When attributes for a file have been changed, the current attributes for the file are 
displayed. 
‘Examples 


1. . This example changes the write-protect attribute of a group of files: 


SAIWRIBSCROGASMU IETS 


: : FILE CURRENT ATTRIBUTES 
i Fe SFO: PROGA.SRC W 
2 7 sFO:sPROGA.OBJ W 
‘ 2. This example sets the system attribute for the TYPE program so it will be 

” transferred onto new system disks (see FORMAT command). es 
~(GErE2E cop ess ier - 
FILE CURRENT ATTRIBUTES 7 

sFOS TYPE, § 
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Program Execution Commands 


You can call a program in three ways: 


. @ Direct execution in which you must respond to any queries from the program 


and to any errors encountered during program execution. 


© Debug execution in which the debugging provisions of the system aid you, in 
identifying and locating program erros. A 

e® Non-interactive execution in which you submit the program as a job to;be 
handled by the system without any interaction on your part. You prepare a file 
that interacts with the program in the same manner as you would during direct 
execution of the program (see the SUBMIT command). 


Two sets of execution commands are provided, one for your 8080- or 8085-based 
programs, and another for your 8086-based programs. 


8080/8085 Program Execution Commands 


The commands described in this section are: 


filename Loads and executes an 8080/8085 program named filename.° | 
DEBUG " Loads an 8080/8085 program, if specified, and gives control 


to the Monitor. 


‘SUBMIT Enters a file that contains commands to be executed. 


Filename—Direct Program Execution | 


Your 8080/8085-based programs are loaded and executed by simply entering the 
name of the file. You may include parameters with the filename to provide control 
over the program to be executed. However, the program must be written to accept 
these parameters and must read the parameters from the line ending buffer. (Further 
details on parameters are given in the Intellec Series II] Microcomputer Develop- 
ment System Programmer’s Reference Manual.) 


DEBUG—Transfer Control to Monitor 


The DEBUG command loads an executable 8080/8085 program, if specified, and 
passes control to the Monitor. . ; 


Command Syntax 
~DEBUG CLs Fa: lfilename {parameters]}<ér> 


. where 


:-Fn: is the directory on the drive n that contains the target file. n is any integer 
value between 0 and 9 inclusive. If :Fn: is not specified, :FO: is the default. 


filename is any 1SIS-II command or the file name of an executable program. 
The program must be an absolute object module. If filename is omitied, control 
transfers to-the Monitor, but no program is loaded. 7 


parameters are the normal parameters of the program to be executed. 


‘Series 1] Operating Instructions : ISIS-I] Console Commands 


Description 


When your executable 8080/8085 program is loaded, the Monitor displays the con- 
tents of the program counter and prompts for a command with a period (.) on the 
system console. 


To begin execution of the program, enter the Monitor G command. You emay 
specify a starting address (entry point address) and up to two breakpoint addrégses 
in the G command. ai 


bs | When execution of your program is suspended at the breakpoint address, you can 

e use other Monitor commands to inspect and/or change the contents of memory 
and/or registers and then continue program execution from the point of suspension 
with another G command. 


You can return to ISIS-I] from the debug mode and reset the debug switch in one of 


the following ways: 
@ Enter the Monitor command G8. 
Posen e- Execute an EXIT system call in the program being debugged. 


® Press interrupt 1. 


Examples ~ 

1. This example executes a program named LIST in debug mode at a load address 
of 3680H: 

a a DEBUGRIAS TMEILE NM XIgcrS 
#3680 
aCKre> 7. 
(The LIST program is executed.) 
i 2. This example executes the same program in debug mode, suspends-execution at 


the specified breakpoint address, and then returns to ISIS-I] with a G8 com- 
mand instead of letting the program issue an EXIT system call: 


SOESUGM AS T@FAL EMI XTAcrO. 

#3680 
“8 aGSSGA0 Str. ie Mi ' 
oe (Use Monitor commands to examine registers and memory when the breakpoint 
; 36A0 is reached.) 


S¢cr> 


ISIS-II,Vx.y 


@ 


3. This example allows you to transfer to Monitor control with no program 
loaded. Return to ISIS-II by entering the Monitor G command with no address. 


SOESUGC COC 
-#0008 


Be 8 ab bee 


Hore ay yt 


SUBMIT—Non-Interactive Program Execution 


The SUBMIT command causes ISIS-I] to take its commands from a disk file rather 
than theconsole. 
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Command Syntax : 
SUBMIT [:Fn:lfilenamel(parameter{, . . .])9)<er> 


where 


filename is the name (and extension, if any) of the file containing the command 
sequence definition (explained below). If extension is omitted, SUBMIT 


assumes the default extension .CSD. ae 


parameter is an actual value that is to replace a formal parameter in the cbm- 
mand sequence definition file. The maximum number of parameters allowed is 
a 10: If you omit a parameter from the SUBMIT list, enter a comma in its place. 


A parameter is a character string of up to 31 characters. Any ASCII character 

from 20H to 7AH is legal, except a comma, space, or right parenthesis. If a 

parameter contains a comma, space, or right parenthesis, enclose the parameter 

in quotation marks. To use a quotation mark inside a quoted parameter, use 
~ two quotation marks in its place. For example: 


‘TITLEC' QUOTE ('') SEARCH ROUTINE'')'§ 


is used in the final command as: 


TITLEC'QUOTE (') SEARCH ROUTINE') 


Description 


SUBMIT uses two files: 


¢ A command sequence definition (CSD) file that contains the command 
sequence definition. You create this file with formal parameters. 


e A command sequence (CS) file that contains the command sequence to be 
executed. SUBMIT creates this file with the actual parameters supplied in your 
SUBMIT command replacing the formal parameters. The command sequence : 
file has the same name as the command sequence definition file but with the 
extension CS. You should not modify this file. 


SUBMIT reassigns the console input device to the CS file it has created and 

returns control to ISIS-I1, which then executes the commands in the CS file. The 

CS file has a final command that restores the console input device to its former ' 
fi device assignment and deletes the CS file. 


When you create the CSD file, specify formal parameters by using two characters, 
Son, where n is-a digit from 0 through 9. You may place formal parameters 
anywhere in the CSD file. To enter a percent.sign (%) that is not to be interpreted as. 

a formal parameter, enclose it in single quotes. 

You can execute any program noninteractively that reads its commands from :Cl:. 

To execute an §086 program under SUBMIT, include the RUN command in the | 
CSD file as shown in example ! below. 


~- The CSD file can also contain commands to the programs being run. If you use a ° 
SUBMIT command in a CSD file, it causes another CS file 10 be created. You can 
nest SUBMIT commands to any depth. 


to aE bes 


A CNTL-E (TE) in a CS file switches the console input from the CS file to the initial 
system console, allowing interactive processing. To return control to the CS-file, 

. enter CNTL-E at the console. If control is not returned to the CS file, or if an error 
occurs after a command sequence has started processing, contro] returns to 1S]S-I] 
and the CS file is not deleted. 


a 
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NOTE 
If a CS file returns control to the initial console device while entering com- 


mands in 8086 mode, CNTL-D and CNTL-C will lose their special meaning, 
i.e., they will not interrupt processing. 


Any program running under SUBMIT must allow two buffers in addition taszhe 
open files and buffers required by the program itself. See the Intellec Series$iII 
Microcomputer Development System Programmer’s Reference Manual - of or 
information on how to determine the base address of your program. 


- 


Examples 


The following example shows a PL/ M-86 compilation executed noninteractively 


“on a 4-drive system. The PL/M-86 command has only three items that change. 


Using SUBMIT to enter the command automates the process, saving you 
keystrokes at the console. 


The command sequence definition is in the file PLM86.CSD. See the iAPX 86, 
88 Family Utilities User’s Guide for 8086-Based Development Systems manual 


_ for an explanation of the controls in the PLM86 command. The file P86.CSD 


contains the following: 
RUN PLM86 :F1:%0.21 DEBUG XREF PRINT CzF3:20.LST) DATE(%2) 


This command sequence definition contains three formal parameters, indicated 
by %0, %1, and %2. The SUBMIT command used to start the compilation is as 
follows: 


a SUBMIZ@PS6CPROGASS ROSES AS EP TOS 0 La scr 


The command sequence created and executed by SUBMIT is shown as it would 
be echoed on the console output device: 


“RUN PLM86 :F1:PROGA.SRC DEBUG XREF PRINT 
C(:F3sPROGA.LST) DATEC(9 SEPT 80) 


SERIES III PL/M-86 COMPILER, V1.0 
PL/M~ 86 COMPILATION COMPLETE 0 PROGRAM ERROR(S) 


eS FOSSUBMIT RESTORE P86. CS(sVIz) 


- 


' This example shows a PL/M-80 compilation, a LINK, and a LOCATE executed 


from a SUBMIT file on a 2 flexible disk drive system. A CNTL-E is entered in 


the command sequence definition after the PL/M compilation so you can | 


remove the compiler disk. When the regular system disk (with LINK and 
LOCATE) is mounted, you enter CNTL-E to resume processing. The text editor 
does not echo the TE; however, it is echoed when the SUBMIT file is executed. 


"The file CMPLNK.CSD in drive 1 contains the following command sequence 


definition. See the AYCS-80/85 Utilities User’s Guide for 8080/8085-Based 
Development-Systems for an explanation of controls in the PLM80 command. 
The CMPLNK.CSD file contains: 


PLM80 40.%1 DEBUG XREF DATE (Re) 
7E 

LINK-%0.0B8J,SYSTEM.LI8 TO 20. SATE 
PRINT(ZO. MP1) MAP 

LOCATE ZO.SAT PRINT(AO.MP2) MAP 


wad eh at 
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The SUBMIT command entered to compile, link, and locate PROGA.SRC follows: 





The command sequence actually executed is shown as it would be echoed on the con- 
sole output device: 


-~PLM80 SF1EPROGA.SRC DEBUG XREF DATE(3 OCT 81) 


Lab 


ISIS-II PL/M-80 COMPILER V3.1 
4 PL/M-80 COMPILATION COMPLETE 0 PROGRAM ERROR(S) 


=TETE > - 

“LINK :F1:PROGA.OBJ,SYSTEM.LIB TO :F1:PROGA.SAT & 
#*PRINT(: FIisPROGA. MP1) MAP 

~LOCATE :F1:PROGA.SAT PRINTC(SF1:PROGA.MP2) MAP 
~:FO:SUBMIT RESTORE sFI:CMPLNK.CS(:VI:) 


Se 8086 Program Execution Commands 


tot 


The commands described in this section are: 


RUN Activates the 8086 execution mode and optionally executes an 
8086 program. 
filename Loads and executes an 8086 program named filename (see the 
- RUN command). 

DEBUG Loads an 8086 program, if specified, and gives control to 
. DEBUG-86. This command is described in Chapter 6. 
é WORK Changes or displays the default drive used for workfiles. | ¢ 

DATE Changes or displays the system date. 

EXIT Exits the 8086 execution mode and returns control to ISIS-II. 


e |  RUN—Activate 8086 Execution Mode 


The RUN command activates the 8086 execution mode, and optionally loads and 
executes an 8086 program. ; 


Command Syntax , ff 
RUN [f:Fnzlfilename (parameters]{;commentsi]<cr > 


w. here 


filename is the name of your 8086 program. If you enter no extension, the 
system assumes a default extension of .86. For example, if you enter MYPROG 
as the filename, the system looks for MYPROG.86. This default extension is 
not assumed if you enter your own extension (or a period and no extension, as in 
_MYPROG. ). : 


be) at bs, 


comment is one or more ASCII characters not including a carriage return or line 
feed. Comments always begin with a semicolon. 
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Description 


When a RUN command requires more than one line, terminate each intermediate 
line with an intermediate line terminator that consists of an ampersand (&) followed 
by a carriage return. You can. optionally insert a comment, preceded by-a semicolon 
(;), between the ampersand and the carriage return. You can enter up to 120 
characters before each line terminator. i 


| When the RUN | program is ready to accept a continued command line, it prompts 
G with two angle brackets (>>). * 


You can enter a comment, preceded by a semicolon, either on a line containing a 
command or on a separate line. If you enter the comment on the same line as a com- 
mand, place the comment after the command. If you begin the comment on a new 
line, use the line only for comments. 


Your program can read the filename and parameters in the command line by calling 
the DOSGETSARGUMENT routine described in the IJntellec Series III Micro- 
computer Development System Programmer’s Reference Manual. 


resees 


Operating Modes. .You can operate the RUN program in interactive or noninter- 
active modes. 


Noninteractive Mode. In this mode you invoke the RUN program and load and 
execute your 8086 program by entering one command. After program execution 
control returns directly to ISIS-I. You must re-enter RUN for each 8086 program to 
be executed. 


Activate this mode as follows: 


RUNS Fai MYPROG Cor. 


Interactive Mode. In this mode you invoke RUN first. RUN ‘signs on; you then ‘ 
load and execute 8086 programs by entering each filename without re-entering 
RUN. After each program is executed, control returns to RUN. 





Activate this mode as follows: 
The Run program signs on and issues its prompt character (>): 


. “ISIS-11 RUN 8086, Vx.y 
> : 


where x.y is the version and release number of the Run program. 


o 
- 
° 
° 
2 


_ You can now execute successive programs by just entering the program name 
foilowed by a carriage return. After each program is executed, the RUN Prem pt 
character (>) is displayed. 


ae 


To return to 1SIS-I] enter the EXIT command (explained later in this chapter). 
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Interrupting Program Execution. To terminate 8086 program execution and close 
files and return control to RUN or ISIS-II, use CNTL-C. CNTL-C returns control 
to the RUN program if you are in interactive RUN mode, and to JSIS-I1 if you are in 
noninteractive RUN mode. 


To interrupt 8086 program execution and enter DEBUG-86, use CNTL-D. 
bad 


Interrupt 1 performs the same functions in 8086 mode as in 8080/8085 mode that 
P is, when interrupt | is pressed, all open files are closed in their current state’, the 
initial console becomes the current console, and control of the system is transferred 
a to ISIS-II. 


Do not use interrupt switch 0 while in the 8086 mode. 


Examples 


1. To activate the 8086 execution mode and run one program (noninteractive 
mode): 


fons RUNS F2-AVG@SRCKcrOn 
2. To activate the 8086 execution mode and run several programs UaieracEve 
mode): 


- 


RUN Soa 

ISIS~I1 RUN 8086, Vx.y 

PETER SFR VESSREKCT> (executes ASM86.86) 
< (executes AVG.86) 

{executes AVG) 

(executes AVG.XYZ) 





WORK—Change/Display Default Drive of Workfiles 


The Work command. changes or displays the default: drive used for (emoerary 
workfiles in the 8086 execution mode. ; : 


= "Command Syntax 
| [RUN] WORK C:Fnz}<cr> 


where 


:Fn: specifies the drive n that is to be set as the default drive for your temporary 
workfiles. n is an integer value between 0 and 9 inclusive. The initial system 
default is :F1: 1f :Fn: is not specified, the current default is displayed. 


Description 


The system assigns filenames in the following form as system workfiles as they are 
created: 


abot bey 


cy 


ann. TMP 


seb ayiyae 


where 


nnn are integer values between 000 and 999 inclusive. 
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If you create files with names of this form on the same disk, they are subject to dele- 

tion unless one of the following conditions exists: 

® Your files have the write-protect attribute set. 

® You use the WORK command to change the default drive being used for our 
workfiles. 


- 


For information on creating temporary workfiles, see the Jntellec Series? II] 
Microcomputer Development System Programmer’s Reference Manual. 


The default drive is saved in the system file RUN.MAC and is obtained from this file 
whenever RUN is activated. The RUN.MAC file is assumed to be on the same drive 
specified for the RUN file. If it does not exist when the WORK command is entered, 
it is created on this disk. 


If the system is already in the RUN program interactive mode, do not enter RUN on 
the WORK command line. 


Examples 


-1. To change the default drive to drive 0 in the interactive mode: 
> Tt SS | 
> 
2. To display the default drive in the interactive mode: 


WORKS cr> 
:FOs 
> ; . 
3. To change the default drive to drive 0 in the noninteractive mode: 


a RUNSWORK G2 #0 =: ‘ 


4. Todisplay the default dive’ in the noninteractive mode: 


a RUNS OR Kir. 


_DATE—Change/Display System Date 


The DATE command changes or displays the system date. 


-« Command Syntax 
C(RUN] DATE Faniananicers 


gf sh be 


_ where 


nn is any integer value between 00 and 99 inclusive that specifies the-date 
desired. If the date is not specified, the last date entered is displayed. The initial 
default date is 09/01/80. 
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Description 


You can enter the date in either the U.S. format (month/date/year) or the European 
format (date/month/year). : 


The system does not automatically update the date but saves the last date entered in 

the system file RUN.MAC and obtains it from this file upon each subsequent invo- 

cation of RUN. The RUN.MAC file is assumed to be on the same disk specifi Le 
: the RUN file. If it does not exist when the DATE command is entered, it is created 
on this-disk. 


If the system is already.in the RUN program interactive mode, do not enter RUN on 
the DATE command line. 


Examples 
1. Toenter the date December 15, 1981 in the interactive mode: 
= DATE ZIA5181ecr> 
: > 
2. To display the last date entered in the interactive mode: 
mpa0Ait<ct> 
12/15/81 | 
? 


3. Toenter the date March 1, 1981 in the noninteractive mode: 


RUN SDATE S037 0198 1<c7>; 


4. Todisplay the last date entered in the noninteractive mode: 3 


SRUNSDATE CCHS 
03/01/81 


EXIT—Exit the RUN Program ‘ 


’ The EXIT command transfers control from the Run program to ISIS-Il1. 


Command Syntax 
EX1T<cer> 


Description. 


Use the EXIT command to return to ISIS-I after an interactive RUN invocation 
--(i.e., RUN was invoked by specifying RUN followed by a carriage return). You can 
. enteran EXIT command whenever the RUN prompt character (>) is displayed. 


a. 2 sebey 


Example . 
To exit the RUN program and return to ISIS-II: 


> EES) 


Ce ee er 


* CHAPTERS 


THE MONITOR 





The Monitor is a program stored in ROM that provides the following supervigory 
functions: ; 4+ 


4 ® Initiation of the system at start-up 
© J/O interface to all standard peripheral devices except disks 
® Software development of your 8080/8085-based programs 


o£ 


hs 


System Initiation 


te The Monitor handles the initiation of the system when you first start up. 


eS 
( In a system without hard disk drives, the Monitor checks drive 0 for a system flexible _ 
disk. ISIS-II files are loaded from disk into memory and control is passed from the 
Monitor to ISIS-II. If a non-system disk is in drive 0, control is retained by the 
Monitor. j 
In a system with a hard disk drive, the Monitor checks drive 4 fora system flexible 
disk. 
After ISIS-II is loaded, you can access the Monitor functions by pressing interrupt 
0. 
1/O Interface 
- The Monitor handles I/O interface to the console, printer, paper tape reader, and ; 
— punch. When an input or output operation to these devices is needed, ISIS-II calls ; 
pres the appropriate Monitor routine. When the operation is completed, the Monitor 
' routine returns control to ISIS-II. 
ISIS-II handles disk 1/O (see Chapter 3). 
8080/8085 Program Development 
. The Monitor provides a command set that enables you to debug your 8080/8085- 
: based programs. Monitor commands allow you to: 
: © Display and modify memory and processor registers: 
“ ® ~—«Initiate execution of your 8080/8085 programs. . 2 
® Insert breakpoints into your 8080/8085 programs before execution. : 


® Read hexadecimal data from an external device into memory. 
@ Write hexadecimal data from memory to an external device. 
© Access user written I/O routines. 
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Command Categories 


The commands described in this chapter are grouped as follows: 


Program Execution Commands 3 
z Execute (G) Transfers control from the Monitor to the loaded 
es program and optionally sets one or two breakpoints in 
: the program 
Monitor 1/O Configuration Commands 
. Assign (A) Changes device assignment 
— Query (Q) Displays the devices currently assigned 
Memory Control Commands 
Display (D) Displays a specified range of memory > 
Fill (F) Fills a specified range of memory with a constant value 
Move (M) Copies the contents of a specified range of memory into 
another area of memory 
" Substitute S) : Modifies memory on a byte-by-byte basis 
‘Register Command (X) 
= Display Form . , Displays the contents of all registers - 


Modify Form Changes the contents of a single register 


‘Paper Tape 1/0 Commands 


Read(R) _ Reads data from paper tape into memory 
_Write (W) Writes data from memory to paper tape - 

ot Ps : 
End-of-File (E) © Writes an end-of-file record to paper tape 


Sob bay 


Null Leader/Trailer(N) | Writes null leader and trailer characters to paper tape 


& 


Utility Command | ; 


Hexadecimal Add and subtract two hexadecimal numbers 
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ashes 


a8 by bey 


Entering Commands 


Your communication with the Monitor is through the system console. When you 
turn on the system. power, the Monitor responds with the following sign-on message 


_and a prompt character (a period) at the left side of the display: 


SERIES II MONITOR, Vx.y 


leah ES 


where = 


oa 


x.y is the version and release number of the Monitor. 


To load an 8080/8085 program from disk into memory for debugging, enter the 
DEBUG command described in Chapter 4 specifying the name of the program to be 
debugged. For example: 


DEBUG TASMYPROG<cro. 


Your program is now loaded, control of the system is passed to the Monitor, and the 
Monitor prompt character (a period) is displayed. 


You can enter commands.at the console anytime after the Monitor prompt character _ 


is displayed at the left margin. 


Monitor commands are single alphabetic characters. Many commands have required 
or optional parameters. Parameters may be alphabetic or numeric as indicated 
under each command.. 


_ Numeric parameters are entered in hexadecimal format. The Monitor recognizes 


only the numeric characters 0 through 9 and the uppercase alphabetic characters A 
through F as legal hexadecimal digits. In this manual, hexadecimal numbers are 
shown with an H appended; however, do not enter the H in a Monitor command. 


Normally, commands are executed when you press the return key on the keyboard. 
Any exceptions to this are fully explained in the individual command descriptions. 


. Command Syntax 


The general syntax of Monitor cowiinands is: 
command parame tersl<cr> 
where: . 
command is the single alphabetic character for the command. 


parameters are one or more variable data supplied with the command. 
Parameters can be numeric or alphabetic. When a numeric parameter is called 
for, it must be entered in hexadecimal form and is limited to four hexadecimal 
digits (OOOH through FFFFH). Larger numbers can be entered, but only the 
four rightmost digits are used by the system. For example, the value 123456H is 
treated as 3456H by the system. . 
Where.a comma is shown in the syntax, you can use either a comma or a space 
unless otherwise noted under the individual commands. 





The Monitor 
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Eniry Errors | 


The Monitor checks for several error conditions: 
® Invalid characters _ 

® Address value errors 

© Checksum errors 


“nb: 


Invalid Characters 


The Monitor checks the validity of each character entered at the Console device. As 
soon as it encounters an invalid character, it displays a number sign (#) and aborts 
the command. It displays the prompt character on the next line and waits for more 
input. In the following example, 4 is rejected because it is not a valid command: 


- 


e 


7 


foe. 


Be The first character entered must be a valid command, otherwise it is rejected by the 
Monitor.. 


- Address Value Errors 


All addresses must be entered in hexadecimal. Any character other than 0-9 and A-F 
is rejected by the Monitor. In the following example, G is not a valid hexadecimal 
digit: . 


PERU BE 5 


Many commands require two addresses where the first address is lower than the 
second. If the first address is higher than the second, the operation will be per- 
formed on the single address specified as the first address. For example, suppose you 
meant to fill memory from address 900 to address 1000 with the constant FFH but 
entered the addresses in the opposite order as follows: 


& arag00s00seexcr> 


The Monitor would place a FF in address 1000H and do nothing else. No indication 
that an error occurred is given. You will only find the error when you notice that a 
’ single byte was filled instead of 100H bytes. 


The valid range of address is OOOOH through FFFFH. If addresses higher than 
FFFFH are entered, only the last four digits will be used when the command i is exe- 
cuted. For example; if 10000H is entered instead of 1000H: ; 


Brad O0 Ds D0 Serxct> 


’ The commend would have been evaluated as: 


Rg * bb Sey 


-F0000,900,FF 


and memory from address 0 through 900 would have been filled with FF. This com- 
mand would have erased some of the memory that the Monitor itself uses. No 
indication of this error is given except that the Monitor wil] not function correctly 
for some commands until you reboot the system. 
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Checksum Errors 


Object code punched onto paper tape by the Monitor or Assembler contains 
checksum digits, which permit the Monitor to detect improperly punched tape or a 
tape reader error condition when the tape is read in. 


When the Monitor detects a checksum error when reading from an input deyjce, 


such as a paper tape reader, it types the number sign (#) and stops reading the tape. 


If a checksum error is detected, reread the tape from the beginning. If checkSum 
errors continue, check the tape reader hardware or check the tape for damage. 


Program Execution Commands 
The following command is described in this section: 


Execute(G) Transfers control from the Monitor to the loaded program and 
; optionally sets one or two breakpoints in the program 


G—Execute Command 
The Execute command transfers control to the program at the address specified or 
implied in the command and optionally sets one or two breakpoints in the program 
to which control is passed. 
Command Syntax 

GCs tart-address] (breakpointi]l, breakpoint2)<cr> 
where 

Gis the Execute command code. 


start-address is the address to be placed in the program counter. Control of the 
system is passed to this address. The address must be specified in hexadecimal. 


breakpoint! and breakpoint2 are points in the program where control is passed 
back to the Monitor. The breakpoints are entered in hexadecimal. 


Description 


The Execute command transfers control from the Monitor to your own program. 
‘You can specify the starting address and one or two breakpoints with the command. 


The starting address is optional. If it is not specified in the command, the address in 
the program counter is used. In the following conditions, you can be sure that the 


desired address is in the program counter: 
e You interrupted your program with the interrupt 0 switch and you have done 
- nothing to destroy the program’s registers. 7 
© You loaded the program from paper tape and the end-of-file record contained 
the entry point address. This entry point address is loaded into the program 
counter by the Monitor. . 
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e You modified the program counter to-your entry point address with the Register 
command. 


® Your program returned contro! to the Monitor because a breakpoint was 
encountered. 


A breakpoint is the address of an instruction within your program that, if fetched, 

results in the return of control to the Monitor. Breakpoints allow you to check the. 

contents of registers or data fields in your program. When a breakpoint is reached, - 
> the instruction at the address is not executed before control is returned to the 
Monitor. The instruction at the breakpoint is executed when you return control to 
your program with the Execute command. 


7, 
Cd 


If breakpoints are specified, the Execute command functions differently than most 

of the Monitor commands. Before the carriage return is entered, the Monitor 

prompts for breakpoints if a comma is entered after typing G. Command entry is in 
_ the following sequence: ‘ 


1. Enter the command code and, optionally, the start-address followed by a 
comma: : 


Bec itA, 
2. The Monitor displays a dash: 
GES - 
3. Enter the first breakpoint address: 
EEE - 
4. Follow step 5 or 6 depending on how many breakpoints you want to set. 
§. ifasecond breakpoint is not to be set, press RETURN: 


RIS - Be) 


6. If a second breakpoint is to be set, enter another comma, enter the second 
breakpoint, and press RETURN: 


- EEE - BERS - BSS 





‘ 


If the command contains a syntax error, no breakpoints are set. The command must 
be reentered and the breakpoints again specified. 





When either of the breakpoints are reached and control is returned to the Monitor, 

or when control is returned to he Monitor because of an interrupt 0, both break- . 

points are eliminated. If you want them when you resume execution of your pro- 4 
gram, you must specify them again. 


There are two important points you must know when using breakpoints to debug 
and test your program: 


® Jn saving the CPU status for your program, the Monitor uses the top 12 bytes of 
* - your program stack. This pushes the status of your registers and program 
counter onto the stack. You: should be aware of this when examining the stack. 
When control is returned to your program, your registers are restored and the 
stack pointer is reset as if the breakpoint had never occurred. 


« © The interrupt system is enabled when the Monitor is entered. The Montor 
cannot determine the state of the interrupt system just prior to exit from your 
program. It is assumed that the interrupt system was enabled and so interrupts 
are enabled when control is returned to your program. It is your responsibility 
to either enable or disable the interrupt system. 


Series 111 Operating Instructions 


Nosens 


a tat be 


Examples: 


1. 


2 


To pass control to the program address in the program counter: 


aG<cr> 


- seni se to the program whose entry pont is 30A: = 


4 


pass ae to the program whose entry is 30A and to set a breakpoint at 
address 400 Mees that program: 


EEE - GSS 


To pass control to the program whose entry point is 30A and to set two 
breakpoints, at addresses 400 and 500, within that program: 


Monitor 1/O Configuration Commands 


The Monitor has four logical system devices defined: 


@ 
@ 
@ 
® 


Console 


Reader © 


Punch 
List 


You have the option of selecting the physical device that will perform the required 
logical device function. The Monitor commands that allow you to control the system 
1/O configuration are: 


Assign(A) | Changes device assignment. 


Query (Q) - Displays the devices currently ern 


The Monitor 


The characteristics of each logical device and the physical ances that can be 
assigned to each logical device are as follows: ° 


® 


@ 
‘ 


The Console is an interactive, character-oriented input and output device. A 


teletypew riter and a CRT terminal have all these characteristics. 


The Reader is a character-orienied input device that transfers data on command 
and notifies the calling system when no more data is available. A paper tape 
reader meets these qualifications. 


The Punch is a character-oriented output device that accepts a character from 
the calling system and records it on an external medium. A paper tape punch 
meets these qualifications. 

The List device is a characte onanied output device that accepts a character 
from the calling program and records it on an external medium in human 
readable form. A line printer meets these qualifications. 


‘A driver program is required for each physical device assigned. The physical devices 
‘for which the Monitor provides driver programs are: 


Teletype console with a keyboard, printer, paper tape reader, and punch. This 
type of device can be assigned to all the system devices. S 


CRT devices with a keyboard that are compatible with the Intellec system: This 
type of devi ice can be assigned to the Console or the List device. 


High speed paper tape reader. This type of device can be assigned to the Reader 


“device. 


High speed paper tape punch. This type of device can be assigned to the Punch 


- device. 
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‘he Monitor 

e Line printer. This type of device can be assigned to the List device. 

e Batch. This is a non-interactive mode in which CONSOLE input is read from 
the assigned READER device and written to the assigned LIST device. In 
preparing a command file for BATCH input, you should enter commands in 
exactly the same way as if the system were in interactive mode. Each command 
should end with a carriage return/line feed pair. The period (prompt) character 
generated by the Monitor in interactive mode should not appear as part of the 

= command. Since the Monitor will continue to read from the READER until the 

‘ CONSOLE is reassigned, the last command in the BATCH command file 

= should reassign the CONSOLE to prevent the Monitor from reading off the end 
of the tape. : 

A—Assign Command 

You can assign one physical device to a system with the Assign command. 

= Command Syntax , 
Alogical-device=physical-device <er> 

where ° 
Ais the Assign command code. 
logical-device is the system device that is to to be assigned a ph ysical-device. The 
possible values for logical-device are: 

: C or CONSOLE 
R or READER 
P of PUNCH. 
+ LorList : 
The equal sign (=) must be entered. 
physical-device is the physical device that is to be assigned to the logical-device. 
. : The possible values of physical-device for each Jogical-device are: 
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~ Logical 


Device _ Physical Device 





— GONSOLE : Tor TTY (teletype terminal) 
ene i -. CorCRT (compatible CRT terminal) - P 
Bor BATCH (batch mode) 
1 (user-defined device for which a user-written program is present) 


. READER Tor TTY (teletype terminal) . 

P or PTR (high speed paper tape reader) 

1 or 2 (user-defined devices for which user-written driver programs are 
present) 


PUNCH T or TTY (teletype terminal) 
P or PTP (high speed paper tape punch) 
“1 or 2 (user-defined devices on which user-written driver programs are 
present) ; : “s 


Qe De ag 


LIST Tor TTY (teletype terminal) 
: Cor CRT (compatible CRT terminal) 
L or LPT (line printer) 
1 (user-defined device for uhich a user-writien driver program is present) 
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Examples 

1. To assign a high-speed paper tape reader as the system Reader device: 
RAR=PACT> 
re) 


r ‘ . 
MAREADER=PTR<cr> 


2. Toassign a CRT terminal as the system Console device: 


> 

iw 

A 

v 
hE: 


or . 


SACONSOLE=CRixcr> 


Q—Query Command 


The Query command displays the current status of the system 1/O devices. It 


displays a list of the system devices and the physical devices assigned to them. 


Command Syntax 


Q<er> 
where. 


Q is the Query command code. No parameters are allowed with this command. 


Example 
To list the current assignments of system devices: 


<r) a 


rm OU so me 
rads 


Hou tt ue 


This response indicates that a teletype terminal is assigned as the Console, Reader, 
and Punch devices. A line printer is assigned as the List device, not the Console 
device. 2°82 > 


| Memory Control Commands : 


There are four Monitor commands for accessing the 8080/8085 memory. The com- 
mands that only read memory can be used on RAM as well as PROM and ROM. 
The commands that write to memory can only effectively be used on RAM. If you 


- specify ROM or PROM with these commands, no error indication is given but the 


write portion of the command is not executed. 


The Memory control commands are: 
® Display (D) Displays a specified range of memory. 
e Fi(F) © Overlays a specified range of RAM with a constant value. ~ 


¢ Move (M) Copies the contents of a specified portion of memory into 
another RAM location. : : 


© Substitute(S) Modifies RAM ona byte-by-byte basis. 
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D—Display Command 
The Display command displays a section of memory formatted into lines of 16 bytes 
separated by spaces with the address of the first byte at the left margin. 


Command Syntax 
Ostart-address,end-address<cr> 


, 
- 


‘ye 


where ; 
Dis the Display command code. 


start-address is the beginning of the memory range to be displayed. The address 
must be specified in hexadecimal. The start-address must be less than or equal to 
end-address. If start-address is equal to end-address, a single byte is displayed. 


end-address is the end of the memory range to be displayed. The address must 
be specified in hexadecimal. - 
Description 


If the List device is not ready, the Display command will hang. To continue the 
operation, make the List device ready, or, if that isn’t possible, press the interrupt 0 
bution on the main chassis. 


Example 


To display the contents of memory locations 109H through 12AH: 





1109 S2Accr> 
0109 09 OA OB OC OD OE OF 


0110 01 02 03 04 05 06 07 08 09 OA 0B OC 0D OE OF 
0120 01 02 03 04 05 06 07 08 09 OA 


F—Fill Command 


The Fill command writes a specified 1-byte constant into a specified RAM area. if 
-ROM or PROM is specified, no error is issued, and the command continues to com- 
pletion even though the TEOTY does not change. 


Fstart-address,end-address,constant<cr> 


where | a 
F is the Fill command code. . 


start-address specifies the beginning of the memory range to be filled with the 
constant. The memory address must be entered in hexadecimal. 


end-address specifies the last byte of the memory range to be filled with the 
constant. The memory address must be entered in hexadecimal. 


constant is the byte to be written to the specified address range. The constant 
must be entered as a hexadecimal number. 


Be a enn oe Soo tenement ee footer encte 2 


PETS OSG te ws veeoes Bp tet ee wee cow 


Description 


If a character other than 0 through F is entered, the command is terminated and the 
prompt character (.) is displayed. 


Example 
To initialize memory locations 20H through 2FH with OOH: 


4 PF20svrsOccr>: 


ead “ 


abe 


" 


M—Move Command 


The Move command copies a specified area of memory into an area of RAM. 


Command Syntax : 
Ee Mstart-address,end-address,destination-address<cr> 
where 


M is the Move command code. 


start-address is the address of the first byte to be moved. The address must be 
specified in hexadecimal. 


end-address is the address of the last byte to be moved. The address must be 
specified in hexadecimal. 


destination-address i is the address to which the first byte (start-address) is to be 
moved. Each subsequent byte i is moved to a Jocation one higher than the last. 


Description ; 

The move is done on a byte-by-byte basis, that is, the first byte of the specified area 

is copied to the new location, then the second byte is copied to the location following 
ae the first new location, and-so forth. The data in the original Jocation is not 


( destroyed. Any data existing at oe new location is overlaid. 


Because the commend worke, ona Svieay bute basis, you should be careful when © 

attempting to move a block of data to a location within the block. By the time the 

command reaches the end of the block, the data will have been overlaid by the first 
’ data moved. 


Examples — 
1. Te move the data currently at address 0100H through 0200H to a address 0400H 
4 through OSOOH: 
. aMIDDSVOD MONEE 
2. To move the data currently at address 1000H through IFFFH to address 1500H 
through 24FFH: " 
AMISDOMIFFEAVAD OSs 
ANID OD SEL ELSES Uses 


ot ob bee 


& IG eeesaeatee SEPISS £82 WPCC AlLIg f13sti UES 


3. If you tried to do the above example with a single command as follows: 


SMID0OMEF FASO scr> 

the first 500H bytes would be copied as you expected, but the second 500H bytes 
would be a copy of the first 500H because bytes 1500H through IFFFH were 
overlaid by the first 500H bytes. 


t 

+ . 

= S—Substitute Command 
The Substitute command displays memory locations on an individual basis and gives 
you the option of modifying each location as it is displayed. 
Command Syntax 

. Saddress,(databytell,(databytel][...]<er> 
= where 


S is the Substitute command code. 
address specifies a RAM address. The address must be specified in hexadecimal. 


data-byte specifies a single byte of data in hexadecimal that is to replace the byte 
currently at the location specified by address. This is an optional parameter. If it 
is not entered, the byte specified by address is not modified. 


Description 
The Substitute command functions differently than most of the Monitor com- 
mands. The function of this command is performed before the carriage return 


(<cr>) is entered. 


The Substitute command functions in the following manner: 
1. Enter the comimand code and the address followed by a comma: 
( 2. The contents of the specified memory location followed by a dash is displayed: . 
_, + BERDIGF F- 
3. You can now do any of the following: 
© Modify the contents of the address by entering a new byte in hexadecimal: 
- BERG FF -E. 
¢ Look at the next sequential byte of data by entering a comma: 
«Beni F-R0 v= 


* End the comma and not modify the data byte by pressing the carriage return 


= key: 
: - BEETS FF -SSSS 
P e Any combination of the first two and finally ending with a carriage return: 


~ BEDUWG F F -EIG00-K1 1 - BEES 
The example changes the first byte from FFH-to AAH, leaves the second 
byte unchanged, and changes the third byte from 11H to 22H. 


PEPiME RESTATE SS 7 @ 
. 


WLS One BOG WH EWES Sy FEELS Mate RSE oot 


The registers you can display and modify and their symbols in the Monitor are: 
Symbol 


CPU A register 
CPU B register 
CPU C register 
CPU D register 
CPU E register | 
CPU flag byte a 
CPU H register ; 

- Jntellec interrupt mask 
CPU L register 
CPU H and L registers combined 
CPU program counter 
CPU stack pointer 


ee 


he 


wd 
Ager rnMO Ow > 


The F register is packed with the CPU condition flags: 


& 76543210 


eet 
always 1 
parity 


always 0 
auxiliary carry 
always 0 

zero 

sign 


X—Register Command (Display Form) 


ra 


This form of the Register Sonmnand displays the contents of all the registers. To 
modify register contents, use the modify form of the command. 


S Command Syntax 
ra X<er> 
where 


’ X is the Register command code. - 





Example. Ae . 
To display the contents of the Intellec registers: 


A=00 B=78 C=00 D=47 E=11 F=02 H=FC I=FC L=20 M=FC20 P=1024 S=CD10 


* ob bey 


- 


~"  X—Register Command (Modify Form) , : 
The modify form of the Récister command allows you to display and optionally 


change the contents of the regisiers, one at a time. 
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Command Syntax 
Xregister, (data] (, dataj] [,...)<er> 


where 


X is the Register command code. 


Le 


; . register is a single register symbol. - as 
=~“ Fd 
data is one or two bytes of data (depending on the register) to be placed in the 
register. The data must be entered in hexadecimal. 


ae 


Description 


This form of the Register command functions differently than most of the Monitor 
commands. The function of the command is performed before the carriage return 
(<cr>) is entered. 


e 


& - | The modify form of the Register command functions in the following manner: 


1. Enter the command code and the register symbol: 
2. Thecontents of the specified register followed by a dash is displayed: 
[Xa FF- 
* 3. You can now do any of the following: 
© Modify the contents of the register by entering new hexadecimal data: 
fg FF-y . 
© Look at the contents of the next sequential register by entering a comma: 
-Ej FR-REE- 
® End the command and not modify the register by pressing the carriage 
return key: 


‘AG FF-RS | } | 
ra .® Any combination of the first two and finally ending with a carriage return: : 
‘a AG) -F FG -H02 - SS 
. . _ This example changes the C register HOH FFH to EEH, leaves the D register 

unchanged, and changes the flag byte from 02H to 82H. 


Examples 
-l. To examine but not phange the M register: 


EC] 1234-253 


'. 2. To examine and change the M register: 


AQ) 1234-Bae SE 


3. To examine all the registers in sequence and change the Dand Hregisters: _ 
EQ] 00-$11-B22-B33-(Ez544-92-BS5-GegzC-HS6-Be r66-MeC9C-RE410-GEs} 
4. To examineand change the interrupt mask (1) and the L register: 


EI Fe-BEY 45-GEE 


a! pe bag 
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Paper Tape |/O Commands . 


The Monitor has four commands to support your use of paper tape: 


Read (R) Reads data from a paper tape into the memory. _ 
Write (W) Writes data from memory to paper tape. 
End-of-File(E) __ Writes an end-of-file record to paper tape. x 


Null Leader/Trailer (N) Writes null leader and trailer characters to paper tape. 


The Monitor reads and writes paper tape in hexadecimal format. This format is 


‘described in Appendix A. 


' R—Read Command 


The Read command reads a paper tape in hexadecimal format from the device 
assigned as the Reader and loads the data into memory at the location specified in 


the record. 


Command Syntax 
Rbias<cr> 


where 
Ris the Read command code.. 


bias is a value (modulo 65,536) to be added to the load address contained in the 
paper tape record. The data is loaded at the memory location specified by the 
record address and the bias value. The bias value must be specified in hexa- 
_ decimal. If there is no bias, a value of 0 must be used. 


NOTE 


_The addition of the bias value does not impiy that the code -is 
relocatable. In some cases, the code would not be executed at the biased 


location. 


Description 
The data read is not changed in any way by the specification of a bias value. 


‘Examples 
1. Toread a paper tape into memory: 


2. To read a paper tape into a memory location that is JOOO0H above the address 
specified in the tape record: 


LEE S= 
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W—Write Command 


The Write command punches the contents of a specified memory area to the 
assigned punch device. 


~ Command Syntax 
Wstart-address,end-address<cr> 


Ln Ss 


ad 
‘ 


where 
W is the Write command code. 


start-address. is the first memory location to be punched onto the tape. The 
start- address must be specified in hexadecimal. 


end-address is the last memory location to be punched into the tape. end-— 
address must be specified in hexadecimal. The end-address must be higher than 
Start-address. 





Description 
‘The Write command does not put an end-of-file record on the paper tape. Thus you 
can punch non-contiguous areas of memory as a single file. The final record in a 
paper tape file must be an end-of-file record. After you have written the last memory 
area to tape, you must write an end-of-file record with the End-of-File command. 


Examples 
1. To write the contents of memory locations 200H through 3AFH to paper tape: 
aHZDDSSAF SCY: | 
2. To write the contents of memory locations 450H through $4FH and locations 
_1000H through IFFFH tO paper tape as a single file: 


ASSO POSER CLOR 
AW1000 MFFfKre> 


E—End-of-File Command 
‘The End-of-File command punches an end-of-file record in all tapes written BY a 
Write command. . pie ay ean ras 


_ Every paper tape fi file must have an end-of-file record as the last record. If the end- 
_ Of-file record i is missing. the pacer will read off the end of the tape. 


Command Sytax 
Eentry-po iatse r> 


a ft ob bey 


. where 


- 


E is the End-of-File command code. 


entry'-point is the entry point.address of the program in the file to which the end- 
of-file record is being added. The entry-point must be specified in hexadecimal. - 
A zero should be specified if an entry point address is not wanted. 
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Description 


You can specify an entry point adress in the end-of-file aeora written with the 
End-of-File command. The entry point address is the address of the first instruction 
in the program to be executed. When this address is specified in the end-of-file 
record, the address is loaded into the program counter when the tape is read with a 
Read command. You can then execute the program by entering a simple Execute(G) 
command. If the load address field is 0, the program counter is not aneied bythe 
Read command. 


Examples 


1. To punch an end-of-file record in a tape that has just been written by a Write 
command: 


RED Kcr, 


2. To punch an end-of-file record in a tape that has just been written and specify 
an entry point address to be used when the tape is read with a Read command: 


RESDNOc<er> ? 


N—Null Command 


The Null command punches a 60 null character leader or trailer. 


-Command Syntax 


N<er> | 


where 


, 


N is the Null command code.- Ef 


Description 


- The null character is a OOH. You should punch a leader before writing data to a tape 
and after the end-of-file record. It makes the tape easier to load and saves the data 
-on the tape from the usual damage that tape ends incur through normal handling. 


Example 


‘To punch a leader or trailer ina paper tape: 


{ARTY 


. Utility Command 


The utility command performs hexadecimal addition and subtraction. 


‘H—Hexadecimal Command 


The Hexadecimal command adds and subtracts two hexadecimal numbers. 


The Monitor 
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Command Syntax 
Hnumber? ,number2<cr> 


where 
H is the Hexadecimal command code. = 
: number! is the first number to be added. This number is used as minuend tbr 
+4 the subtraction. The number must be entered in hexadecimal. e 
= aumber2 is the second number to be added. This number is used as the sub- 


trahend for the subtraction. 


Description 
The numbers can include up to four hexadecimal digits. 


ae The command displays two four-digit values. The first is the addition of the two - 
numbers and second is the subtraction. Negative numbers must be entered in their 


two’s complement form. 


If more than four digits are entered, the command uses the rightmost four digits. 
The leading digits are lost. 


Example 
To add and subtract E49 (minuend) and 111 (subtrahend): 


RHESLS S23 AK ceS. 


OFSA 0038 


“abe beg 


& 


CHAPTER 6 
DEBUG-86 





DEBUG-86 is a program stored in ROM that provides symbolic debugging of sour 
8086 programs. DEBUG-86 provides an English language command set that enables 


; you to: : 
2 Initialize DEBUG-86 and load your program from a disk file. 
rs e Specify starting and stopping conditions for program execution. 


® Execute your program in real-time mode. 
® Execute your program in single-step mode. 
e Display and alter 8086 registers, memory locations, and 1/O ports. 
iy The files to be debugged by DEBUG-86 must contain executable 8086 object 
cae modules. This means that the translator output must be either linked and located to 
produce an 8086 absolute object module, or linked with the LINK86 BIND control 
to produce a Position-Independent Code (PIC) or Load-Time Locatable (LTL) 


object module. These processes are described in the iAPX 86, 88 FAMILY . 
UTILITIES USER’S GUIDE for 8086-Based Development Systems. 


The development cycle for LTL code is faster because you don’t have to locate your 
source code. The loader locates your code in memory as the code is reached. 


Absolute object modules should be located at 7800H. 


e 


Command Categories 


Utility Commands 


DEBUG Activates DEBUG-86. 
one EXT .. — Exits DEBUG-86. 
LOAD Loads your program code into 8086 memory. 





-Execution Commands 
GO | Causes execution of your program until \ breakpoint 
; conditions are met. 


GR : Sets or displays the contents of the Go register. 


STEP - Causes execution of a single program instruction. 


af. 


Change Commands 
Change Register Changes the contents of 2 single register or status flag. ~ 
Change Memory Changes the contents of 8086 memory locations. 


Change Port ' Changes the contents of hardware !/O ports. 
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Display Commands 


Display Registers Displays the contents of user 8086 registers. 


Display Memory Displays the contents of 8086 memory locations. ra 
Display Memory Displays the contents of 8086 memory locations in ba6 
~ (ASM form) Assembly language mnemonics. of 
- Dispiay Port Displays sontente of 1/0 ports. 
Display Stack Displays contents of user’s stack. 
Display Boolean Displays boolean value of input. 
‘Evaluate | Displays a value in five number bases. 


Symbol Manipulation Commands 





Define Symbols Enters a new symbol in DEBUG-86 symbol table. 
DispiaySymbols —_— Displays symbols and their values. 

Display Lines Displays statement numbers and their values. 
Display Modules Displays module names. 

Change Symbois Changes value and type of symbols. 


Remove Symbois--- Removes- specified symbols or modules, or all modules, 
symbols, and statement numbers. 


Set Domain Sets a default module for statement number references. 


_ Compound Commands 


& as | . Repeat ‘ Causes looping of a command. 
ae : Count _ ae : Causes looping of acommand. 
y i : a ee Causes execution of a command if a specified condition is . 
woe ae: es 
Character Set 


‘The valid characters in the DEBUG-86 command language are: 
__.® Upper and lower case alphabetic ASCII characters A through Z 
‘ “e Digits 0 through 9 
© Blank space or comma 
® Carriage return/line feed 
e $asaseparator in combined words, asinDATASENTRY. : 
® Algebraic operators: +, —, *, / 
° Relational operators: =, <, >, <=, >=, <> 
* The characters ?, @,&.3, 23-5 G)i +. 8.55 % 


All other characters are errors. 
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Continuation tines: ae 


Invoking DEBUG-86 


You can invoke DEBUG-86 in either of two ways: 

® Using the 8C86 DEBUG command. This method allows 15k of memory for the 
DEBUG-86 symbol table, which means space for about 1500 symbols (assuming 
an average of 10 characters per symbol). However, no 1/O buffers are allocated 
‘for your program regardless of the number of buffers you may. have requesfed. 
(None are assumed necessary during debugging.) 


® Using CNTL-D to interrupt your 8086 program execution and. chter 
DEBUG-86. This method allows 3k of memory for the DEBUG-86 symbol 
tables, which means space for about 300 10-character symbols. Buffers are 
allocated as specified in your program. 


Entering Commands 
Your communication with DEBUG-86 is through the system console. DEBUG-86 
displays an asterisk prompt (*) at the left margin when it is ready to accept a com- 


mand from the console. _ 


DEBUG-86 takes input from the console but does not interfere with the original 
command line. 


For example: 





ARUN MM <cr> J MDEBUGCRPLHESSPROGSSRCSPRINT MS iP: 


will load the compiler and transfer control to DEBUG-86. DEBUG-86 does not read 
the parameters on this command line but goes back to the console for instruction. 
When the PL/M-86 program is finally executed, the command line parameters are 
still available to it using DOSGETSARGUMENT (see the Intellect Series JI] Micro- 
computer Development System Programmer’s Reference Manual.) 


You can enter up to 120 characters per input line before entering a line terminator (a 
carriage return or a line feed). On the Intellec terminal, a line feed is amiomaucally 
entered when’ you press the RerceN key. 





_ A command line can consist of one or more input lines. If you need to continue a 
~ line, terminate it with one of the following intermediate line terminators: 


.®- Aline terminator embedded ina String that is enclosed in quotes. 


® A line terminator preceded. by an ampersand ae that is not embedded in a 
quoted string or a comment. 
In this case, characters entered between the pees and the line terminator 
are ignored: and the eu persanee is treated as a space. 


“When the system is ready to accept a continued line, it displays two asterisks (**). 


Comments . . ; 


You may use comments in any input line. Begin the comment with a semicolon (). If 
the line contains commands, place the semicolon and comments after the com- 
mands. If you start an input line with a semicolon, use the line only for comments. 


-DEBUG-86 


” DEBUG-86 
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If you use an ampersand to continue a commandline that also contains comments, 
place the ampersand before the semicolon. An ampersand that is embedded in a 
comment is ignored. 


Commands are not stored internally. The main use of comments is to document an 
execution session while it is in progress. 


* bp - 


Line Editing ao 
You can use ISIS-II line editing functions to correct errors in the current input line 


before you enter a line terminator. See Chapter 3 for a description of the line editing 
characters. 


Interrupting Program Execution 


_ You can interrupt 8086 program execution and enter DEBUG-86 by using CNTL-D. 


You can terminate 8086 program execution, close files, and return control to RUN 
by using CNTL-C. If CNTL-C is entered while the system is servicing a em call, 
a pause may occur before control is transferred. 

Interrupt 1 performs the same functions in 8086 mode as in 8080/8085 mode. That 
is, when you press interrupt 1, all open files are closed in their current state, the 
initial console becomes the current console, and control is transferred to ISIS-I1. 


You should not use interrupt 0 while in the 8086 mode. 


Error Conditions | : 


For syntax errors, DEBUG-86 displays the input line including the error followed by 


a number sign (7) anda carriage return. 


For all errors, DEBUG-86 displays the following error message: 


~- ERROR xxx 
where 
xxx is a decimal error number. 


Error messages are defined in Chapter 7. 


Expressions 


You can use expressions as command arguments to specify numeric values or 
boolean (true/false) conditions. An expression is a formula that evaluates to a 
number and represents one of the following; 


e .Pointer—a pair of 16-bit unsigned integers. The first integer of the pair is called 
- the base and the other integer is called the displacement. 


° Integer—a single 16-bit unsigned integer treated modulo 65536, where any bits 
bey ond 16 bits are not used. This is a special case of pointer, with the base value 
equal to 0. 
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DEBUG-86 provides only unsigned-integer arithmetic on pointers and integers. 


Arithmetic operations are applied separately to bases and displacements (i.e., 


integer arithmetic is always 16-bit). Signed arithmetic is not provided. 


The following are examples of expressions. 
e Expressions containing a single value: 


3 3 

FRFFH | . | 3 
e Expressions containing operands, operators, and parentheses: ee 

ra ae 

1747/4 

QO100H + OOFFH 

2* (6 + 4) 


(127 + 44)/20 
@ Expressions containing symbols: 


.SYMBA - 2 
(4 eMOD1.SAM + 21. 


The following sections describe the operands and operators that you can use in 
expressions. . 


Operands 


You can reference the following types operands: 
e Numeric constant 
® Command keywords 


© Keyword references 


° Register references 

© Memory references 

® -Port references = 

© Symbolic references: 

e. Statement number references 
® String constants 


Numeric Constants 
A numeric constant produces a fixed unsigned 16-bit integer value, and consists of 


’ decimal digits 0 through 9, the letters A through F (hexadecimal digits), and the suf- 


fix H for the number base. You do not have to enter the suffix Hy it is the default 
base. 


You can specify numbers in other bases by entering the suffix for the new base, as in 
.100T. The suffix T = decimal base, Q = octal base, and Y = binary base. 


The Evaluate command displays constant values in five bases. 


Command Keywords 


Command keywords are system-assigned names of command functions to be exe- 


cuted. Examples are LOAD, GO, STEP, REGISTER, FLAG, ASM, STACK, and 
EVALUATE. 
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Keyword References 


Keyword references are system-assigned names of system variables such as registers, 
status flags, ports and memory. Keyword references allow you to access system 
variables to display or modify their contents. 


You can use keyword references in three ways: 

® In an expression, as in RAX+5*8. The keyword value returned is the cuffent 
contents of the referenced object. 

e Alone as in RAX<cr>. The current contents of the referenced objects are 
displayed. 

® On the left side of an equals sign as in RAX = 5555<cr>. The contents of the 
referenced object is set to the value on the right side. 


If the value referenced is less than 16 bits, the system right-justifies the value and 
fills the unused high-order bits with zeroes. If the value is larger than 16 bits, the 


extra high-order bits are lost. 


Register References 
To access a register, use the corresponding keyword reference listed in table 6-1. 
The functions of all registers except the pseudo registers are described in The 8086 


Family User’s Manual. The pseudo registers are described under the GO command 
in this chapter. 


Memory References 
When | you reference a a memory location, use the f ormat: 





memory-type address 
where memor} “type is one of the following: 
BYTE, a one-byte integer value located at nisiipaee 


WORD, a two-byte integer value with low byte at address and high byte at 
address +1. 


SINTEGER, same as BYTE. 
INTEGER, same as s WORD. 
POINTER, a four-byte pointer value located at address through address +3. 


The value of address must be an integer. 
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Table 6-1. 8086 Register Keyword References 


Type of Register 8086 Register and interpretation 


16-bit Accumulator 

High 8 bits of Accumulator 
Low 8 bits of Accumulator 
16-bit Base Register 

High 8 bits of Base Register 
Low 8 bits of Base Register 
16-bit Count Regisiter 

High 8 bits of Count Register 
Low 8 bits of Count Register 
16-bit Data Register 

High 8 bits of Data Register 
Low 8& bits of Data Register 


: : SP 16-bit Stack Pointer 
Pointer Registers 16-bit Base Pointer 
16-bit Source index 
(oe index Registers aie 16-bit Destination Register 


16-bit Code Segment Register 
16-bit Data Segment Register 

16-bit Stack Segment Register 
16-bit Extra Segment Register 


General Registers 


- 


Auxiliary-carry out of low byte to high byte 

Carry or borrow out of high byte 
Direction of string manipulation instruction 
Interrupt-enable (external) 

Overfiow flag in signed arithmetic 

Parity 

Sign of the resuit of an operation 

Trap used to place processor in single step mode for 
debugging: ; 
Zero indicates a zero value result of an operation 


Go register; controls breaking of real-time execution 
Breakpoint registers 
Breakpoint register 0 


Pseudo Registers ~ 
Sy 3 Breakpoint register 1 





ba 
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When you change memory or reference.it in an expression, BYTE is equivalent to 
SINTEGER and WORD to INTEGER. However, when you display memory, the 
form of the display is either unsigned (BYTE, WORD). or signed (SINTEGER, 


INTEGER). 


Examples: 


BYTE 1000H 
WORD 101 
INTEGER.ABLE 
POINTER CS:IP 


AL 


wo 


Port Reference 


DEBUG-86 supports a maximum of 64K 8-bit (PORT) or 16-bit (WPORT) ports. 
To reference ports, use one of the following formats, depending on the size of port 
desired: 


PORT address 
WPORT address 


Examples: 


PORT 123 
PORT RDX 
WPORT TFFH 


Symbolic References 


DEBUG-86 maintains a ae table and a source program statement number table 
that allow you to use symone addressing. The DEBUG-86 tables acquire symbols in 
two ways: 


1.- When you load your program with the LOAD command, your program symbol 
information i is copied to the DEBUG-86 symbol tables. 


2. When y you use the Define Symbol eofimand: you enter additional spmitislece into 
- the symbol table for use during the debugging session. 


"The number of symbols possible depends on how DEBUG-86 was invoked: 


_'e If you invoke DEBUG-86 with the 8086 DEBUG command, 15k of memory is’ 


available for the DEBUG-86 symbol tables. This provides space for about 1500 
symbols (assuming an average of 10 characters per symbol.) 


a If you invoke DEBUG-86 by interrupting 8086 program execution ii : 


CNTL-D, 3k. of memory is available for the DEBUG-86 symbol tables. This 
provides. space for Spout. 300 10-character symbols. : 


¢ 


A symbol table value is assigned to each symbol. This value represents either the 
address or the numeric value of the symbol. When vou reference a symbol, you are 
retrieving its address or numeric value.- 


The following types of symbols and corresponding values are loaded into the tables: 
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.. referencing the program location via the statement number. 


Symbol Type Value ~ 
Instruction and statement labels Address of the instruction 
Program variables Address of the variable 
Program constants , Constant numeric value he 
; os 
Module names None assigned a 


In a PL/M-86 or PASCAL-86 program, a module name is the label of a simple DO 
block that is not nested in any other block. In an Assembly language program, a 
module name is a label that is the object of a NAME directive. 


Symbols contained in a module are local to that module. To reference a symbol 
name that occurs in different modules, specify the desired module. 


The symbol table is organized to preserve the modular structure of your program. 
Before code is loaded, the table contains a single unnamed module that always 
comes first. Named modules follow in the order in which they are loaded. Local 
symbols are stored in the named module in the order of their appearance. Symbols 
defined without a module name are stored in the unnamed module in the order in 


_ which they are defined. 


When you enter a symbol reference as an operand, its value is obtained from the 
table and used in the associated expression. To reference a symbol, use the following 
format: 


[..module].symbol ... 


If you specify a module name, only that module is scanned; otherwise the entire 
table is scanned. When you specify more than one symbol, the table is scanned for 
the first occurrence of each symbol in sequence. The system returns a pointer con- 
taining the base and displacement address values for each symbol. 


By assigning symbolic names to modules, procedures, and variables, you gain flexi- 
bility in retrieving interrelated variables. For example, assume that the symbol .X 
represents a Variable that is used in procedures PROCX, PROCY, and PROCZ of 
module MODA,. You could then retrieve the symbol .X in each procedure as 
follows: . 


»eHODA.PROCX.X 
- HODA.PROCY.X 
-»-MODA.PROCZ.X 


Statement Number Reference 


When vou reference a statement number, you reference -the first instruction 
generated by the compiler for the source statement. In other words, you are 


‘ 

If different modules (each with its own statement numbers) are linked, or if more 

than one module is loaded in the DEBUG-86 statement number table, specify a 

module name in the statement number reference, as follows: 
[..module }#statement-number 


The statement number is an integer value. If it does not have an explicit suffix, the 


default suffix is decimal. The value returned is a pointer value that is the absolute: 


address of the first instruction generated by the compiler for the source statement. 


DEBUG-86 
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Examples: 


AAS 
»~-TESTI#12H 


String Constants 


You can enter any ASCII character (ASCH codes 00H through 7FH) asa see can- 
= stant by enclosing the character in single quotes. The operand value of a string con- 
stant is a 16-bit integer with the high-order bits set to 0, and the low-order seven bits 
- set to the ASCII code. For example, the siring constant ‘A’ has the value 
0000000001000001 Y (0041H). 


Table 6-2 lists the printing ASCII characters and their corresponding hexadecimal 
codes. (A blank space means a nonprinting character.) 


Table 6-2. ASCII Printing Characters and CODES (20H—7EH) 


peseese 


Space (SP) 


i 


o 
38 or me 


|- 4+ one en « 


foosens 


Veesaee 


a 
b 
c 
d 
e 
f 
9 
h 
i 
d 
k 
I 
m 
n 
° 
Pp 
q 
t 
s 
t 
u 
v 
Ww 
x 
y 
z 


WOO YUM MH bh WA A O~> 


IV EAS: 





cs Operators 


An expression can contain any combination of unary and binary operators. A unary 
operator takes one operand, and a binary operator takes two operands. 


Table 6-3 describes the operators you can use with DEBUG-86. The operators are 
shown as they are entered in expressions and are ranked in order of precedence from 
: highest (1) to lowest (10). 


For discussion, the operators are classed as shown in tabie 6-4. 
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Table 6-3. DEBUG-86 Operators 


1 als 
Eee core 


Base, displacement integer connector for a pointes 
(@.g., 1234:5678 or CS:1P). 


Unary plus. 

Unary minus; (-N) means. (65536-N), the we 
~ complement of N, modulo 2"€ : 
Integer multiplication. 


integer division. The result is the integer quotient; 
the remainder (if any) is lost. 


Modulo reduction. The remainder after division, 
expressed as an integer. 


Addition. 
Subtraction. 


content- -Treats operand as memory or port address, returns 
operator’ the content of that address. 





ls equal to. Result is either TRUE ‘FEEER) or FALSE . 
(0). 

Is greater than. Result is TRUE or FALSE. 

ts less than. Result is TRUE or FALSE. 

Is not equal to. Result is TRUE or FALSE. 

Is greater than or equal to. Result is TRUE or FALSE. 

Is Jess than or equal to. Result is TRUE or FALSE. 

‘Unary Logical (1°s) complement. Bitwise 1 becomes 


0, 0 becomes 1; TRUE becomes FALSE, FALSE 
becomes TRUE. 


Bitwise AND. If both corresponding bits are 1's, 
resuit has 1 in that bit; else 0. TRUE AND TRUE yields 
a TRUE result; any other combination is FALSE. : 


i : Bitwise inclusive OR. If either corresponding bit is a 
: 1, result has 1 in that bit; else 0. If either operand is 
TRUE, resultis TRUE; else FALSE. 


Bitwise exclusive OR. If corresponding bits are 
different, result has 1 in that bit; else 0. If one operand 
is TRUE and the other is FALSE, result is TRUE; if 
both are TRUE or both are FALSE, result is FALSE. 





Notes: 

14 = highest precedence (evaluated first), 10 = lowest precedence. 
2u = unary, b= binary. : 
3efer to text for additional details. 


ae ‘content-operator is one of the tokens BYTE, WORD, SINTEGER, INTEGER, POINTER, 
\ : PORT, or WPORT. ; 
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Table 6-4. Classes of Operators 





















(Numeric) 
Arithmetic 
unary +,-, 
binary "ols ‘MOD, +, 


“oy gue 






Content 
unary ~ 









content-operaiors 






(Boolean) 


















Relational 

binary =>, 0, 22, <= 
Logical 

unary NOT 

binary AND, OR, XOR 





+ , a ’ 
content-operators , 
NOT 












ms f; MoD, +, ~, oy 
relational-operators, 
AND, OR, XOR 







Relational Operators 


A relational operator calls for a comparison of its two operands. The six relational 
operators are shown in table 6-4. Each comparison evaluates to a result that is true 
(FFFFH) or false (0). 


Arithmetic Operators 
The DEBUG-86 scanner distinguishes unary. ‘‘+’’ and ‘‘~”’ Fei binary ‘‘+’’ and 


**—"? by context. (Unary ‘‘+’’ is ‘superfluous, since it is the default.) 


fe oe Unary ‘‘~’’. A unary “—’" applied to an integer means 2’s complement modulo 
be 65536. In pa words, (-N) evaluates to (65536—N). As DEBUG-86 uses only 
\ unsigned arithmetic, unary ‘‘—’’ does not apply to pointers. 


Binary ‘‘+’’. Binary ‘‘+’’-applies-to pointer and integer values only and results in 
the arithmetic sum of its two operands. 


When you add two integers, the result is treated modulo 65536 (any high-order bits 
after the sixteenth bit are dropped). 


_... When you add a pointer and an integer, the displacement value of the pointer is 
‘ ° summed with the integer modulo 65536 and the base value of the pointer is 
’ unchanged. 


Binary ‘‘-’*. Binary ‘‘-’’ applies to pointer and integer values only and results i in 
the ae difference to the two operands. 


When you subtract an integer from another integer, the result is the 2’s complement 
difference. The result is treated modulo 65536, so that a negative result (-N) 
becomes (65536—N). 
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When you subtract an integer from a pointer, the result is the 2’s complement dif- 
ference of the pointer displacement and the integer modulo 65536, and the base 
value of the pointer remains unchanged. 


When you: subtract a pointer from another pointer (they must have the same base), 
the result is the 2’s complement difference of the displacements modulo 65536, and 
the resulting base value is set to 0. An error occurs if the base values of the poinzers 
are different. = 


= Binary ‘“*’’, ‘*/’’, and ‘“MOD”. These operators apply only to integer operands 
and return only integer results. 


Binary ‘‘*’’ results in the multiplication of two integer operands, truncated to the 
low-order 16 bits. 


Binary ‘‘/”’ causes the first integer operand to be divided by the second. The result is 
the integer quotient; the remainder, if any, is lost. Thus, (5/3) evaluates to (1). 





Binary “MOD” returns the remainder after integer division as an integer result, and 
the quotient part of the division is lost. Thus, (5 MOD 3) evaluates to (2), the 
remainder of (5/3). P 


Content Operators 


Content operators are keywords that refer to the contents of memory locations and 
1/O ports. In expressions they function as unary operators with precedence immedi- 
ately below subtraction. Table 6-5 summarizes the content operators. 


To be used in an expression, a content operator must precede a single operand that is 
a valid address. A range of addresses (using a keyword such as TO or LENGTH) 
cannot be used in an expression. 


. 


Table 6-5. ‘Content Operators 


| Operator | , , Content Returned 


BYTE . 1-byte integer value from the addressed location in user memory. 













_ WORD 2-byte integer value from the addressed location in user memory. 






SINTEGER, Same as BYTE. 





INTEGER Same as WORD. 


POINTER 4-byte pointer value from the addressed location in user-memory. 





PORT 1-byte value from addressed 8-bit 1/0 port. 





WPORT 2-byte vaiue fromaddressed 16-bit 1/O port. 
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The four logical operators and corresponding examples are shown in table 6-6. 


The logical operator NOT results in a 1's complement of an operand; a 16-bit 


operand is assumed. 


‘The logical operators AND, OR, and XOR each compare a pair of bits. Each 


operator causes different results as shown in table 6-6. 


Table 6-6. Logical Operators 


Bit Comparison 


Operator 
pee fet one 


FFFFH 
FFFEH 
1111111100001001Y 
0 


NIA NOT 0 
NIA NOT 1 
NOT 11110110Y 
NOT FFFFH 
ES NOT FFFEH 
0 AND 0 
1010Y AND 1001Y 
FFFFH AND 0 
FFFFH AND FFFFH 
1 AND 0 


0 OR 0 
1 OR 0 

1010Y OR 1001Y 
FFFFH OR 1 
FFFFH OR FFFFH 


0 XOR 

1 XOR 0 

1010Y XOR 1007Y 
: FFFFH XOR 0 


FFFFH XOR FFFFH 





2 
- 
= 
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Arithmetic and Logical Semantic Rules 


Table 6-7 provides a summary of the semantic rules that apply to arithmetic and 
logical operations. The table specifies the function performed by each type of 
arithmetic and logical eperalicn: the input required, and the result of the operation 
(output). 


“ior 


Table 6-7. Arithmetic and Lagical Semantic Rules 


AND, OR, XOR Zintegers integer _ | Bitwise conjunction or disjunction of integers. 
NOT integer integer | One's complement ofan integer. 


<>, <2, 98,0, 2 *?2pointers,same | integer j Logical tesf of relational expression. if the displace- 
base ment integer values satisfy relational operation (true), 
® Zintegers integer | then the output integer value = FFFFH. H the disptace- 
ment integer values do not satisty the reaitional opera- 
tion (faise}, the output integer = 0. If the base values of 
the input pointers are not equal, an error occurs. 





Zintegers integer | Unsigned product (*), quotient(/), or remainder (MOD) 
: : of two integers. 
BYTE, WORD, INTEGER, pointer or integer {| Fetches content of memory location addressed by 
SINTEGER integer input value. 


POINTER pointer or i Fetches content of memory location addressed by 
es “integer — input value. 


PORT. WPORT integer integer { Fetches content of 1/0 port (@-bit or 16-bit) addressed 
: by input value. = 
« pointer. integer pointer | Sum of the displacement values, same base as the 
s integer. integer integer | pointer. Sum of the integers. 


*2 pointers with integer | Two's complement diterence of displacement values. 
= base values Error occurs if base vaiues are unequal. 

* pointer & pointer {| Two's complement difference of pointer displacement 
integer value and integer input. same base as the pointer. 





~{unary} integer integer { Two's complement of the input integer. 


+(unary) + Alltypes same No change. 


override : sinteger& pointer | pointer {| Replaces current base value of pointer with input 

tase/ . integer value. 

construct *Zintegers ' pointer | Constructs new pointer with base value set ‘to firs: 

pointer input integer value and dispiacement set to second 
. integer. $ 





apres, 
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Command Contexts 


All expressions produce numeric values as results. The interpretation or use of the 
result depends on the command that contains the expression. Contexts that control 
the interpretation of an expression are summarized in table 6-8. 


A numeric expression is an expression in a numeric command context which ~treats 

the result as a numeric value. All bits are significant. 

; A boolean expression is an expression in a boolean command context. Only integer 

= values may be used in boolean contexts. The least significant bit (LSB) of the result 
is tested to obtain a TRUE or FALSE value. The result of a boolean expression is 
TRUE if its LSB is 1, FALSE if its LSB is 0. 


A boolean expression uses relational and logical operators to manipulate 
TRUE/FALSE values. When a relational operator is evaluated, the result is either 0 
(FALSE) or FFFFH (TRUE). These results can have a numeric interpretation, but 
relational operators have limited usefulness in numeric contexts. 


~ When logical operators are applied to TRUE/FALSE values, the results are also 
boolean, as follows: 


NOT: .NOT FALSE — TRUE 
NOT TRUE ~ FALSE 


AND: TRUE AND TRUE - TRUE 
TRUE AND FALSE - FALSE 
FALSE AND TRUE -+ FALSE 
FALSE AND FALSE - FALSE 


. OR: TRUE OR TRUE ~ TRUE 
TRUE OR FALSE ~ TRUE 
FALSE OR TRUE - TRUE 
FALSE OR FALSE -> FALSE 


XOR: TRUE XOR TRUE — FALSE 
TRUE XOR FALSE — TRUE 

5 . FALSE XOR TRUE — TRUE 

Fore FALSE XOR FALSE - FALSE 


' Table 6-8. Command Contexts ‘ 


Numeric aca Setandchange | 16-bit unsigned All operands and operators | [P= AA°256T + 10FFFH 
commands, etc. | number, bit size | allowed. Numeric constant 
may be reduced to | without suffix is interpreted 


fit destination. in hexadecimal radix. 
Bocleanexpression | BOOL.IF, - LSB=0-FALSE | All operands and operators | AA AND .83 ANO NOT .CC 
2 UNTIL, LSB =1— TRUE allowed. Numeric constants 
oe : WHILE —~ without suffix are interpreted 
‘ es ; in hexadecimal radix. 
: Address : FROM, Pointer to ; Only arithmetic operators are | GO FROM .88 +10 
2 content- : memory of allowed outside of the outer- 


operator, 16-bit (or fewer) most parentheses. Constant: 
partition .| addressin without Suffix are interpreted 
memory or 1/0. in hexadecimal radix. 


vf Decima! number siziement- positive number No operators are aliowed 
number outside the outermost paren- 
theses. All constants without 

suffix are cec:mal. 
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ag de, 


Utility Commands © 


DEBUG-86 utility commands provide file management capabilities. The utility com- 
mands are: 


DEBUG Activates DEBUG-86. 


$*p 


ExiT Exits DEBUG-86. 


wo 


LOAD ~—— Loads user program code into memory. 


DEBUG—Transfer Control to DEBUG-86 
The Debug command activates DEBUG-86. . 


Command Syntax 
C:Fni]RUN DEBUG [L:Fn:]filename (parameters)] <r? 


where 
RUN: is a command Peyivend thal invokes the 8086 execution mode. 
DEBUG is a command keyword that invokes DEBUG-86. 
filename is the name (including extension) of a program that is a valid absolute, 
PIC, or LTL 8086 object module. If no extension is specified, RUN adds an 


extension of .86. If filename ends with a period (as in MYPROG.), the null 
extension is assumed... 


parameters is a series of one or more ASCII characters (separated by commas or 
spaces) representing variable data required by the user program and to be pro- 
cessed by the program... 


Abbreviation’ oe ce ae ~ 


-None-.” 


Description 


" You can operate DEBUG-86 in either interactive or noninteractive mode. 


1 


_ Noninteractive Mode. Specify DEBUG and optionally vour program on the RUN 


activation line, as follows: 
-7C:Foa:JRUN DEBUG [[:Fn:] fi lenamel (parameters) ]]<cr> 
DEBUG-86 signs on, then prompts fora command with an asterisk (*): , 


DEBUG 8086, Vx.y 
+ 4 


where x.y-is the version and release of the DEBUG-86 program. 
When you issue an EXIT command after the debugging session, control returns 


directly ro JSIS-11. 
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Interactive Mode. Specify the RUN program only on the RUN activation line as 
follows: : 


“C{sFn:]RUN<cr> 
RUN signs on, then prompts for a command with an angle bracket: 


ISIS-II RUN 8086, Vx.y 
> 


ee ae 


t 


; where x.y is the version and release number of the RUN program. 
Issue the DEBUG command and optionally specify your program as follows: 
DEBUG [L:Fn:] filenamel (parameters) ]]<cr> 
DEBUG-86 signs on, then prompts for a command with an asterisk. 


ES When you issue the EXIT command after the debugging session, control returns to 


ie the RUN program which displays.its prompt (>). The system remains in the RUN 
‘ interactive mode, and you can execute or debug another 8086 program. 


To return control to ISIS-II, issue an EXIT command to the RUN program. 


Loading Your Program. You can load the program to be debugged in either of 
two ways: 


Noninteractively,. by specifying the program on the DEBUG command activatio 
line. DEBUG-86 signs on after the program is loaded. 


2 


Interactively, by specifying only DEBUG on the command activation line. 
DEBUG-86 signs on without loading your program. You then load your program 
with the LOAD command explained later in this section. Use this method only if 
there are no parameters to be passed to your program on the command line. If you 
use this method, you must enter the entire filename including the ‘default extension 
a .86 that is added by RUN. This method also loads the DEBUG-86 symbol tables. $ 


Examples _ a ee 
1. To activate the 8086 interactive execution mode: 
SRUN<K CT : 
- -YSIS-11 RUN 8086, Vx.y. 
“>PySfse 
DEBUG 8086, Vx.y 
- 


2. To'transfer control directly to DEBUG-86: 


-Be Rn eas 
DEBUG 8086, Vx.y = 


* 


BE bey 


3. Toload your 8086 program and transfer control to DEBUG-86 in one step=" 


-AUTT yaa aay, ths 
DEBUG 8086, Vx.y 


* 
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4. To transfer control directly te DEBUG-86 then load your program with the 
LOAD command: 


a RUNSDESUEScT> 


DEBUG 8086, Vx.y 


LOAD M@FACPROGCERECcTO 


* 


as oe 


- 


EXIT—Exit DEBUG-856 
The EXIT command exits DEBUG-86. 


Command Syntax 
rae EXIT<cr> 


where 


EXIT is a command keyword that transfers control from DEBUG-86 to the 
RUN program in the interactive mode, or to ISIS-I] in the noninteractive mode. 


Abbreviation 
EXIT can be abbreviated to EX]. 


Description 
In the noninteractive mode, the EXIT command operates as follows: 


eRUNMDESUGS cree 
DEBUG 8086, Vx.y - 
EXE TKcrS engess 


In the interactive mode, the EXIT command operates as follows: 


BRUNSCT> 

1S1S-11 RUN 8086, Vx. y 
MOEBUG< cr he 

walle 8086, Vx.y 


rite 


ed 


ars The last EXIT command i is the RUN EXIT command (see Chapter 4, ISIS-II Con- 
- sole Commands). ” : - 


For further oF onaten on interactive and noninteractive modes, see the DEBUG 
command explained on the previous page. 


Possible Error Conditions : 


None, except for possible ISIS-I] errors that may occur when the system is in 
noninteractive mode and you are returning to ISIS-II. 
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_Example 


BEXIaxcr> 


LOAD—Load 8086 Object Code in 
The Load command loads 8086 object code from the specified disk directory and f ile 
into 8086 memory. The Load command is the only way to load symbols and line 
- numbers into the DEBUG-86 symbol table. 


Command Syntax 


ree NOSYMBOL 
pane C:Fnslfilename (ee |... <er> 


where 


filename is the complete name of a disk file that is a valid absolute, PIC or LTL 
8086 object module. A default extension is not assumed; you must provide an 
extension. 


| NOSYMBOL is a Mmodifi jer that prevents the program synbel table from being 
loaded. 


NOLINE is a modifier that prevents the program line number table (in 
PL/M-86 or PASCAL-86. programs) from being loaded. 


ae é "ai 


Abbreviation 
LOAD can be abbreviated to LOA, NOSYMBOL to NOS, and NOLOAD to NOL. 


Description 


- The Load command allows you to load the local symbols and their types if present, 
source statement numbers, module names, segment and group names, and object 
- code from the specified file. 


For absolute programs, no checking is done for RAM being present. If your pro- 
gram is located in the memory address space where no memory exists, no Warnings 
will be given. - . 


Sef For PIC and LTL code, the loader allocates only existing memory. The system 
prevents code from piling up in 8086 memory beyond previously loaded PIC/LTL 
i code by deallocating 8086 memory space before loading. The system inserts 
= symbolic information in the associated module and symbol tables in the order 
* encountered. A base and aa value are loaded for all-symbols and state- 

re . Ment numbers. : P 


You can enter the NOSYMBOL and NOLINE modifiers in any order or combina- 
tion. When you use more than one modifier, separate them with spaces. A modifier 
may not be specified twice in the same load command. 
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| Examples 


Possible Error Conditions 


Invalid object files cause an error message to be displayed and abort the load 
operation. 


Unsatisfied externals cause a warning to be displayed but do not abort the load 
operation. a 
22 


a 


1. Toload an absolute, PIC, or LTL file from a disk in drive 0: 


LOAD S£0 2 ESTSWRIXCTO 


2. To load an absolute, PIC, or LTL file from a disk in drive 2 without loading 
program symbols: 


LOAD Ms 22ABSOCOSDEZENOSYNSOix<cr- 


3. Toload an absolute, PIC, or LTL file from a disk in drive 1 without loading the 
program statement numbers: 


LOAD & FAcCLOUNTZONESNOLINESKcrO 


Execution Commands 
This section describes the following commands: 
GO Executes your program until breakpoint conditions are met. 
GR Displays or changes the contents of GR. 
STEP —_ Executesa single program instruction. 
These cominends allow you to specify the address where execution is to-begin, and 


to specify the conditions for halting and returning control to the console for further 
commands. 


‘After your program code is loaded, DEBUG-86 initializes for execution by loading 


the instruction pointer (IP) and code segment register (CS) with the address specified 
by the loaded object module. — ; 


‘In PIC and LTL code, SS and SP, and DS or ES may also be present with CS:IP. 


GO—Execute 8086 Instructions 


The GO ‘command transfers control of the system to your program at the address 


- specified or implied wie executes instructions until breakpoint conditions, a. any, 


are SUSIE RS 


Command Syntax 


é é CFOREVER] 
GO CFROM address] { {TILL break-address [OR break-addressJ] <erm 
(TILL break-register (OR bresak~-registerjd] 


where. . 
FROM address specifies the address of the first instruction to be executed. If 
FROM address is omitted, execution begins at the address in the 1P and CS. The 
address must specify the CS:IP content in the form nnnn: nnnn, as ‘in 800:0 
(leading zeros need not be entered). 


' DEBUG-86 
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NOTE 


If address is entered in the form 8000, for example, a relative jump 
could add a displacement to the value in the IP and cause an 
overflow. The CS:IP then would not reflect the desired value. 


FOREVER is a function keyword that disables all breakpoint conditions. 


Ae 


TILL is a keyword introducing one or more breakpoint conditions. 


break-address is an integer expression entered as a pointer that references a 20- 
bit execution address. 


break-register is one of the breakpoint registers, BRO or BR]. The address for 
BR forms a 20-bit memory address where DEBUG-86 writes a one-byte inter- 
rupt to get control. 


Abbreviation _ 
GO can be abbreviated to G, FROM to F, and TILL to T. 


Description 


The GO command begins real-time execution, optionally loading the CS and IP with 
a starting address, and continues until the breakpoint conditions are satisfied. 


FOREVER Condition. When you enter a simple GO FOREVER command, execu- 
tion begins at the current CS:IP address and continues until one of the following 
occurs: 


_® You enter a CNTL-D character. (If your program disables 8086 interrupts, the 
abort is disabled.) 


© A fatal error occurs (explained in Chapter 7). 
e Your program executes a system call to the EXIT routine. 


When you enter the CNTL-D character, the following operations occur: 
e DEBUG-86 completes executing the current instruction or system call. 
e- Execution halts; the IP and CS contain the address of the next instruction to be 
executed, 
© The next instruction to be executed is disassembled. 
® is message PROCESSING ABORTED is displayed, acknowledging the user 
abort. ao plies : 


_ Instead of having your program -execute forever, you may specify one or two 


breakpoints. 


‘Breakpoints. A breakpoint is the address of a program instruction that results in 


... the return of control to DEBUG-86. A breakpoint allows you to check the contents 


of registers or data fields at the specified point in your program. 


DEBUG-86 modifies user memory when entering execution and when a breakpoint 
is reached and repairs it when you return control to your program with the GO com- 
mand. The instruction at the breakpoint address is not executed until your program 
regains control. a 


~ Ifa breakpoint is set at the starting address for resuming execution, a single step is 


executed, then the GO command, to enable you to keep a breakpoint the same when 
executing loops. 
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. Examples 


AR WN 


‘Display form: 


where 


Breakpoint Registers. This option uses the contents of the breakpoint registers, 
BRO and BR], as breakpoint addresses. 


To change the contents of either breakpoint register, or BR when setting both 
registers to the same value, use the form: 


tbreak-register = address<ctr> 


ble 


To display the contents of either the BRO or BR1 breakpoint register, use the form: 


+ break-register<cr> 


Possible Error Conditions 


Since DEBUG-86 must modify memory to get control, it cannot perform the break 
function in ROM. DEBUG-86 cannot enter GO with the 8086 Trap Flag (TFL) set. 


is 


° 


e 


& 
* 
* 
* 
& 
* 


GR Change/Display Go Register 


The Go Register (GR) command changes or displays the contents of the go register. 


Command Syntax . 


~~ GR<cr> 
Change form: 


FOREVER ; 
GR = {TILL break-address (OR break-address] <er> 
TILL break-register (OR break-register]) 


: FOREVER is a keyword that disables all breakpoint conditions. Execution 
stops only when you abort processing. a 


TILL is a keyword that introduces one or more breakpoint conditions. 
break-address is an integer expression entered as a pointer that references.a 20- 
bit execution address. The first break-address sets the contents of BRO; the 
second break-address.sets the contents of BRI. 


break-register is one of the breakpoint registers, BRO or BR] (or BR to denote 
both breakpoint registers), that is to be enabled. 
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Abbreviation 
TILL can be abbreviated to T. 


Description 


The GR defines breakpoints conditions currently in force. By setting the contents of 
GR to a breakpoint condition (using the change form of the command), you dd not 
have to re-enter the breakpoint conditions each time you restart execution with the 
GO command. ; 


Entering GR<cr> displays the contents of GR. 


Possible Error Conditions 


Error 126, Symbol does not exist. 
Error 137, Module does not exist. 


F sence Z 


pe Examples 
: 1. 


& 
* 
* 
* 


= STI LISS RIKcTS 


sg 


| 
GRS=MEDREVERC CTS 

* 

EGRESS. 

4. (Er RRR Ae Ue sis 
: 





& 
6. asa FP) Fett Sse 


( _STEP—Execute a Single Instruction 
The STEP command causes the execution of a single instruction in your program. 


Command Syntax 
STEP EFROM addressl<cr> 


where 
FROM address specifies the address where single step execution is to begin. If 
- FROM address is omitted, the address in the IP and CS is used. The address 
must specify the CS:IP contents in the form nnnn:nnnn, as in 800:0 (leading 
zeros need not be entered). 


7 = ' NOTE 
, IF address is entered in the form 8000, for example, a relative jump 


_ could add a displacement to the value in the IP and cause an 
overflow. The CS:IP then would not reflect the desired value. 
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Abbreviation 


DEBUG-86 


STEP can be abbreviated to S or STE, and FROM to F or FRO. 


Description 


When the STEP command is first issued, it initializes the user environment for 
single-step execution, optionally loading a Starting address, and executes one 
instruction step. A subsequent step is executed each time you enter the STEP Yor 2) 


command. 


After each step, the system displays the disassembled instruction to be executed 
next. If the step command is embedded in a compound command (described later in 
this chapter) the next instruction to be executed is not disassembled. This gives you 
the ability to make multiple steps and lets you decide whether to disassemble or not 
with the ASM form of the Display Memory command. 


The Step command is a powerful debugging feature for repeat loops (compound 
commands) where you can give the terminating condition (UNTIL or WHILE) and 
display system status and values after each step. 


Possible Error Conditions 


Error 126, Symbols does not exist. 
Error 137, Module does not exist. 


Examples 


1. *BiRs re) 
* 
2. ° thegay -sitt) Freie ese 
3 Bh ag : 
3. bere. 5 ieee 


4. the eh Pie 
* 


6. *hhi FT eho te oo 


Change Commands 





This section describes the Change commands that allow you to change the contents 


of 8086 registers, 1/O ports, and memory. The Change commands are: 


Change Register - 
Change Memory 


Change Port 


Changes the contents of a single register or 
status flag. 


Changes the contents of 8086 memory 
locations. : 


Changes the contents of I/O ports . 
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Change Register—Change Content of a Register 
The Change Register command changes the contents of a single 8086 processor 


register or status flag. 


Command Syntax i 
register = change-exp<cr> 


- where 


register is one of the following keyword references: 


8086 Recister Type Keyword References 
8-bit registers RAL, RAH, RBL, R8H, RCL, 
‘RCH, RDL, RDH 
ot , 16-bit registers RAX, RBX, RCX, RDX, 
SS | : SP, BP, Si, Di, SS, 


CS, DS, ES, IP, RF 


1-bit status flags CFL, PFL, AFL, ZFL, 
; SFL, TFL, IFL, OFL, OFL 


change-exp is a numeric expression specifying the new contents of register. 


Abbreviation 
None 


Description 


If change-exp contains fewer bits than the specified register, the bits are right- 
justified and the unspecified high-order bits are set to zeroes. 


' 


If change-exp contains more bits than the specified register, the extra high-order bits 
in are lost. ‘ 


Possible Error Conditions 


Error 148, Integer value required 
Error 147, Pointer value required 


Examples 
1. _ To change the contents of AX to 0000H: 
= 2. To change the contents of IP to F23AH: é 


bjt Poe SACC YS. 


* 
3. To change the contents of CS to the word value located at WORD.SAM: 


JCS S—-au0RDISANScrO 


3 
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Change Memory—Change Contents of Memory Locations 


The Change Menous command changes the contents of one or more memory 
locations. 


Command Syntax 


we 


= 
> 


memory-type address j{T0 end~-address] 
CLENGTH nj 


= change-exp ([,...]19<er: 
where 


* memory-type is one of the following keywords: BYTE, WORD, SINTEGER, 
INTEGER, POINTER. 


address is a memory location entered as a pointer value containing a base (which 
can be omitted if 0) and a displacement. If a range is accessed, address is the 
starting address. address can be either: 


® A numeric expression, the result of which is an address modulo 65536. 


cas © A memory content reference of the form (memory-type address), as in 
f BYTE(WORD 1000). The content of the address or address pair inside the 
parentheses is treated as the address for the memory-type outside the 
parentheses. 


TO end-address specifies the upper limit of a range of memory that is to be 
modified. The end-address must be greater than or rape to address. Both 
addresses must have the same base. 


LENGTH n specifies the number of bytes, words, or pointers (depending on 
memory-type) to be modified. The value n must be an integer value. 


change-exp is the value to replace the contents of the specified memory location. 
Up to 19 change-exps may be listed. The change-exp must be a pointer value if 
memory-type is a pointer; otherwise, it must be an integer value. The change- 
exp may be any of the following: 


e A numeric expression, representing a single value. 


e A string, enclosed in quotes, that represents consecutive bytes consisting of 
an . the ASCII equivalents of the string characters. 


rereers 


e> <p ° 6A range of memory addresses, representing consecutive Bytes, words, or 
* double words of user memory. 


Abbreviation - 


BYTE can be abbreviated to BYT, WORD to WOR, SINTEGER to SIN, 
INTEGER to INT, POINTER to POI, and LENGTH to LEN 


Description 
‘ To change the contents of a single memory location, use the form: 
= memory-type address = change-exp<cr> 


- To change the contents of a range of memory locations, use any of the following 
forms: 


1. memory-type address = change-exp [,...]19<cr> 


In this form the upper limit of the destination Tange is implicit in the number of 
change-ex. (ps listed. 
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2. memory-type address 10 end-address = 
change-exp (,...]19<cr> 
lf the number of change-exps is smaller than the range, the system repeats 
values as necessary. If larger than the range, the extra values are lost and an 
error occurs. 


With this form, you access memory depending on memory-type specified, as 

follows: 3 

© BYTE or SINTEGER. You access each byte location in the range, including 
address and end-address. 


e ‘WORD or INTEGER. Address pairs are accessed until end-address is 
reached. If end-address is the low address of a pair, the last word is formed 
from end-address and the next address. 


POINTER. Address quadruples are accessed until end-address is reached. 
If end- address is the low address of a quadruple, the last pointer is formed 
from end-address and the next three addresses; if end-address is not the low 
address of a quadruple, the access ends after the previous quadruple. 


3. memory~type address LENGTH n = change-exp [,...119<cr> 


This form specifies the actual number of bytes, words, or pointers to be 
modified. Access can begin with even- or odd-numbered address. The range is 
filled as described under the second form above. 


@ 


Possible Error Conditions 


Error 149, Invalid base error 
Error 124, Partition bounds error 
Error 148, Integer value required 
Error 127, Memory failure 

Error 139, Excessive data 


Examples 
1, Tochange the byte contents of a single memory location 800:30H 


OYIt@8 00°30 ee ErIO 
= : 
2. Tochange the byte contents of a range of memory locations to a single value: 


BYTE M8 00°30 SEN S16 %-m0 D<cr> 


3.. To replace the byte contents of a range of memory locations with a list of new - 
values: : 


* 
2 





4. To replace the word contents of a single memory location with the contents of © 
the register IP: ; 


WORDS500°5 05-8 Psrr> 


ba * = 
5. Toincrement the contents of a single memory location: ~ 


BWORBS0D5S 0G UORSD S=F 5 etek 


£3 


6. Tochange the pointer contents of a single memory location: 


SPOINTERSS 0025 0B BABLD ad ys4<cr> 


3 
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7. To replace the byte contents of a range of memory with a string: 


J3YSESS00550S-MABLCDEicrS 


* 


8. To replace the pointer contents of a range of memory with the contents of a 
second range of menIOn: 





x 
si 

= te ae 

s 9. To-change the byte contents of a memory location referenced by a statement 


number: 


* BYTES 6 SSF ASCE 


& 


© Change Port—Change Contents of I/O Ports 


The Change Port command changes the contents of one or more I/O ports. 


Command Syntax 


{TO end-address) 


= = ~2.J19<er> 
{LENGTH n] © | thange-exp [, 19<er 


port-type address 


where | 


port-type is one of the f ollowing: 
® PORT—references the 8-bit port value at address 


e WPORT—references the 16-bit port value at address and address + 1, one 
byte at a time and not as a single 16-bit port value. 


address is the address of an 8086 port and is an integer value between 0 through 
65,535 inclusive. If a range of ports is specified, address is the starting address 
of the range. 


- TO end-address specifies the upper limit of a range of port addresses. The end- 
. address is an integer value between 0 and 65,535 inclusive, and must be greater 
than or equal to address. Both addresses must have a base of zero. 


LENGTH n specifies the number of port or word pert addresses to be 
displayed. The value of n must be an integer. 


change-exp is the value to replace-the contents of the specified port. Up to 19 
change-exps of the following types may be listed: 


® Anumeric expression that represents a single value. 


© A String enclosed in quotes that represents consecutive bytes sgnsisting of 
eon the ASCII equivalents of the string characters. 


: e A range of memory or port addresses, representing consecutive bytes or . 
: . words of user memory or I/O ports. 


Abbreviation 
PORT can be abbreviated to POR, WPORT to WPO, and LENGTH to LEN. 
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Description 
To change the contents of a single port, use the form: 


port-type address = change-exp<cr> 


To change the contents ofa Tange of ports, use one of the f clowns forms: 


BY 


1. port-type sddieee = ae exp [,...]19<er> a 
The upper limit of the SeertnaOn range is impueit in the number of hangeeens 
listed. 


2. port-type address 10 end-address = change-exp [,...119<er> 


If the number of change-exps is smaller than the range, values are repeated as 
necessary to fill the range. If the number is larger than the range, the excess 
values are Jost and an error occurs. 


3. port-type address LENGTH n = change-exp C,...119<cr> 


This form specifies the actual number of ports to be modified. Access can begin 
on an even- or odd-numbered address. The specified range is filled as described 
under No. 2 above. 


Possible Error Conditions 


Error 148, Integer value required _ 
Error 124, Partition bounds error 
Error 139, Excessive data 


. Examples 


1. Tochange the contents of a single byte port: 


LS PORTSDS —ah7ixcr> 


* 


2. Tochange the contents of a range of byte ports: 





3. Toreplace the contents of a range of ports with a string: 


PORTH D 0D tt 090054 SARCOE Ere 


a; 


’. 4. To filla range of ports with the same value: 


POR G10 0 OMEN 25SEC 


* 





Anerror message such as ERROR 140 is displayed. 
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Display Commands 


This section describes the commands that enable you to display the following 
systems elements: 


® 8086 processor registers 


@ 8086 status registers = 
® Memory e, 
® Ports 


8 Status flags 
The Display commands are: 
Display Registers Displays contents of 8086 registers. 
Display Memory Displays contents of 8086 memory locations. 


Display Memory Displays contents of 8086 memory locations in 8086 


(ASM Form) Assembly language mnemonics. 
Display Port Displays contents of I/O ports. 
Display Stack Displays contents of user’s stack. 


Display Boolean Displays boolean value of input. 


Evaluate Displays an integer value in five number bases or a pointer 
value in five hexadecimal digits. 


Display Register—Display Contents of 8086 Registers 
The Display Register command displays the contents of one or more 8086 processor 


registers and status flags. 


Command Syntax 


register{, ...]19] — 
REGISTER <er> 
FLAG | 


_ where 


register is any of the eis Sore references (up to 19 can be entered, 
separated by spaces}:_ . ; sae 


8086 Recister Type Keyword References 


8-bit registers RAL, RAH, RBL, RBH, RCL, 
; RCH, RDL, ROH 
16-bit registers RAX, REX, RCX, RDX, SP, 7 
. ' BP, St, DI, SS, CS, DS, : 
ES,IP,RF - 
1-bit status flags ; CFL, PFL, AFL, ZFL, SFL, 


TFL, IFL, DFL, OFL 
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REGISTER is a command keyword that causes the display of all the 16-bit 8086 
registers. 


FLAG is a command keyword that displays all the 1-bit status flags. 


Abbreviation 
REGISTER can be abbreviated to R or REG, and FLAG to FLA. 


- 


AS 


Description 
The referenced values are displayed on 80-column-wide lines separated by spaces 
according to the appropriate format, as follows: 


8-bit-register-name = byte 
16-bit-register-name = word 
status-flag-name = bit 


Possible Error Conditions 


Syntatic errors are possible. 


Examples 
1 Todisplay the AX, BH, SP and AFL registers: 
RAXSRBH SSP RA FIxXcro: 


RAX=0001H RBH=2FH SP=FFE7H AFL=0<cr> 


2. To display all nineteen 16-bit registers: 
+A DTT or * EKITS 


RAX=O000H REX=00A2ZH RCX=0001H ROX=0010H SP=000AH BP=O000H S1=0123H DI=0000H 
CS=QO00K OS=FFIEH SS=0000H ES=O000HRF=0000H IP=FABCH 


3. To display the nine status flags: 


FERS 
CFL=0 PFL=0 AFL=0 ZFL=0 SFL=0 TFL=1 IFL=0 DFL=0 OFL=0 


Display Memory—Display 8086 Memory 


. The Display Memory command displays the contents of one or more 8086 memory 


locations. 
Command Syntax 
memory-type address He eee ieee <er> 


where 


memory-type is one of the following keywords: BYTE, WORD, SINTEGER, 
INTERGER, POINTER. - 
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address is a pointer value that contains a base (which need not be entered if 0) 

and a displacement and specifies an address of a memory location. If a range is 

specified, address is the starting address in the range. The address can be either: 

e¢ A numeric expression, the result of which becomes an address modulo 
65536. 

© A memory content reference in the form (memory-type address), as in 
BYTE(WORD 1000). The content of the address or address pair inside the 
parentheses is treated as the address for the memory-type outside the 

, parentheses. 


TO end-address specifies the upper limit of a range of memory. The end-address 
must be greater than or equal to address. Both addresses must have the same 
base. 


LENGTH n specifies the number of bytes, words, or pointers to be displayed. 
The value n must be an integer. 





Abbreviation 


BYTE can be abbreviated to BYT, WORD to WOR, SINTEGER to SIN, 
INTEGER to INT, POINTER to POI, and LENGTH to LEN 


Description 
To display the contents of a single memory location, use the form: 


memory-type address<cr> 


To display the contents of a range of memory locations use either of two forms: 
1. memory-type address T0 end-address<cr> 
2. memory~type address“ LENGTH n<cr> 


In 1 and 2 above, memory is accessed as described under the Change Memory 
Command. : 


ee '. Each line of display contains the memory address of the first value followed by a 
“maximum number of values depending on memory type, as follows: BYTE—16, 
WORD—8, SINTEGER—8, INTEGER—8, POINTER—4. 


Possible Error Conditions 


Error 149, Differing bases 
Error 124, Partition bounds error 


Examples 
1. To display the byte contents of location 800:30H: 
Pee 3 4 G5 00250 fcr} 
BYT 0800:0030H=66H 
a Ze To display the byte contents of locations 800:30H through 800:30H: 
BYT O800:0030K=66H 6FH 72H 20H 70H 72H 6FH 67H 72H 61H 
3. Todisplay the word contents of location 800:30H: 


EE 
‘WOR 0800:0030H = EFOGH 
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4. Todisplay 16H words beginning at location 800:30H: 
WORSE 0025 0M ENG Scr . 
WOR O800:0030H=6F466H 2072H 7270H 676FH 6172H 7360DH 
§. To display the pointer contents of location 800:30H: 
J POINTER SSO0=S0<cr>| 
POI 0800:0030H=2072:6F66H a 
= 6. Todisplay the POINTER contents of locations 800:30H through 800:3BH: ; 


o POIG@BO0=30 Ms 0M800=38<cr- 
POI 0800: 0030H=2072:6F66H 676F:7270 7360:6172H 


Display Memory (ASM form)—Display 8086 Memory in 
ASM Form 


a The ASM form of the Display Memory command displays the contents of one or 
ses more 8086 memory locations in 8086 Assembly Janguage mnemonics. 


Command Syntax 


ASM address J{T0 end-address]}| <cr> 
{LENGTH nj] 


where 


address is a pointer value that contains a base and a displacement and specifies 
an address of a memory location. If a range is specified, address is the starting 
address in the range. The address can be either: 


e A numeric expression, the result of which becomes an address modulo 
65536. 

® A memory content reference in the form (memory-type address), as in 
BYTE(WORD 1000). The content of the address or address pair inside the 
parentheses is treated as the address for the memory-type outside the 
parentheses. 


tome TO end-address specifies the upper limit of a range of memory. end-address 
[ must be greater than or sue to address. Both addresses must have the same 
base. 


LENGTH n specifi es the number of mus words, or pointers to be displayed. 
The value of n is an integer. 


Abbreviation. 
LENGTH can be abbreviated to LEN 


Description 


> The specified range of memory is disassembled into 8086 Assembly language in the 
following format: 
° Address Prefix Mnemonic Operands Comments 
FF00:0390 IN “ AL, DX 
FF00:0391 TEST AL,07H 


FF00:0393 JE $-06H 7; SHORT 


DEBUG-56 . . : Senes Hl} Operating lastiuenons 


4. Todisplay 16H words beginning at location 800:30H: 
SUORBSO0SS SENSE OK CYS _ 
WOR O800:0030H=6F66H 2072H 7270H 676FH 6172H 736DH 
5. Todisplay the pointer contents of location 800:30H: 
J PDI NIERBSODSS0Kcr> 
POI 0800:0030H=2072:6F66H 
6. Todisplay the POINTER contents of locations 800:30H through 800:3BH: 


- JPDigsOD=30StDR600=S5Scr> 


- POT 0800: 0030H=2072:6F66H 676F:7270 7360:6172H 


i o 


” 


Display Memory (ASM form)—Display 8086 Memory in 
ASM Form 


The ASM form of the Display Memory command displays the contents of one or 
on more 8086 memory locations in 8086 Assembly language mnemonics. 


Command Syntax 


ASM address {[T0 end-address]| <cr> 
: [LENGTH nl] 


where 


address is a pointer value that contains a base and a displacement and specifies 

an address of a memory location. If a range is specified, address is the starting 

address in the range. The address can be either: 

e A numeric expression, the result of which becomes an address modulo 
65536. 

© A memory content reference in the form (memory-type address), as in, 
BYTE(WORD 1000). The content of the address or address pair inside the 
parentheses is treated as the address for the memory-type outside the 
parentheses. 


Se TO end-address specifies the upper limit of a range of memory. end-address 
must be greater than or equal to address. Both addresses must have the same 
base. 


LENGTH n specifies the number of bytes, words, or pointers to be displayed. 
The value of n is an integer. 


Abbreviation. 
Nes can BPE abbreviated to LEN 


Description 


The specified range of memory is disassembled into 8086 Assembly language in the ~ 
Fy following format: 


¥ Kadress Prefix. Knemonic Operands _Conments 
FFO0:0390° IN AL, DX 
FFO0:0397_ TEST AL,O7H 
FF00:0393 JE $-06H s SHORT 


ete Re a ee ene een Seen 
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where 
ADDR marks the first byte (or prefix) of the instruction in hexadecimal. 


PREFIX identifies any prefix byte other than segment override (such as LOCK, 
REPE, REPNE) that may be specified. If none is specified, the column is blank. 


MNEMONIC is the 8086/8087/8088 macro assembler mnemonic tonite 
instruction. 


J OPERANDS define zero or more operands séearated by commas. Register 


° operands are any of the 8086 registers: AL, AH, BL, BH, CL, CH, DL, DH, 
: AX, BX, CX, DX, SI, DI, BP, SP. 


The disassembled memory operands used by DEBUG-86 have the following format: 


pe cs BYTE » sf BX, , > »fDt), , » »L XXXXXHY, , 
ae DSt: WORD (PTRi [ JBPL ] [Jstt ] { J 
( ES DWORD : +xxH 

ss/ Sf 2 ~xxH 


_ Example: the display ES:BYTE PTR [BX] [SI] [+01H] 
represents the operand BYTE ES:(BX+SI+1) 


where- 

© The first field is the segment register field and is only displayed if the instruction 
has a segment-override prefix. 

‘* In the second field, an entry ‘‘?PTR’’ means that the type of the pointer cannot 
be determined from the context. 
Example: LEA AX,? PTR [34A0H} 

® In the third and fourth fields the base register (BX, BP, and index register (DI, 
SI) fields are not displayed for direct memory operands. When ° 
these fi elds are displayed, they are enclosed in brackets. 

ae @ The last field i is either a 16-bit unsigned (word) number, or a a signed a bit Ceaie) 
; number. The entry is displayed enclosed in brackets. 

° At least one of the last three fields (base register, index TEgISIES, number) is 

displayed for any memory operand. 


Examples 
. 1, To display the contents of address 800:9C7H in ASM form: 
SE ASH 20 00> 9L7Kr¥- 
ADDR Tee HMNEMONIC OPERANDS COMMENTS 
= 0800:09C7H HOV AX, WORD PTR [1848H] 
° 2. To display the contents of a range of addresses in ASM form: 
- BASHSSDOSSSCHENS Mt 
ADDR outs PREFIX MNEMONIC OPERANDS COMMENTS 
0800: 0B8CH 58B BYTE PTR [BX](SI],AL 
0800:0B88EH JE .S+29K s SHORT 
0800: 08C0H CALL $+0038H 7 SHORT 
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Display Port—Display 1/0 Port Contents 


The Display Port command displays the contents of one or more I/O ports. 


Command Syntax 5 
a ; ET0 end-address] . % 
i port-type address Piece A <er> : 
= where | 


port-type is one of the following keywords: 
@ PORT—references the 8-bit port value at address. 


e WPORT—references the 16-bit port value at address and address + 1, one 
byte at a time and not as a single 16-bit port value. 


fh address is the address of an 8086 port and is an integer value between 0 through 
65,535 inclusive. If a range is specified, address is the starting address of the 
range. 


TO end-address specifies the upper limit of a range of port addresses. end- 
address is an integer value between 0 and 65,535 inclusive, and must be greater 
than or equal to address. 


LENGTH n specifies the number of port or word port addresses to be 
displayed. The value n must be an integer. 


Abbreviation 
PORT can be abbreviated to POR, WPORT to WPO, and LENGTH to LEN. 


Description aa 


To display the contents of a single port, use the form: 


os - * port-type address<cr> 


To display the contents of a range of ports, use either the TO end-address form or 
the LENGTH n form. 


Possible Error Conditions 


Error 148, Integer value required 
Error 124, Partition bounds error 


. _ Examples 
1. To display the contents‘of the byte port at address 120H: 


PORT Gar 0 sre> 
. POR O120H=8FH 


2. To display the contents of a range of byte ports: 


BPORT&2 0 SN OM bscr> 


POR O120K=8FH 7FH BFH 7FH BFK 7FH 


eR bes 
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3. Todisplay the contents of a single word port at address 120H: 


uPORi@erOecr> 
WPO O120H=7FBFH 


4. Todisplay the contents of a range of word ports: 


PUPORT@ cORtomzs<cr 


WPO O120H=7FBFH 7FBFH 7FBFH 7BBFH 7BBFH 


ae on ie 


i 
" 


- 


Display Boolean—Display Boolean Value 


The Display Boolean command displays the boolean value of the input value. 


Command Syntax 
cee BOOL expression<cr> 


where 


expression is an integer expression, the result of which is evaluated to a boolean 
value. If the least significant bit of the result equals 1, the boolean value is 
TRUE; otherwise the boolean value is FALSE. 


Abbreviation 
BOOL can be abbreviated to BOO. 


Description 
A boolean expression is an expression that is contained in a boolean command con- 


text. The least significant bit.of the result is tested to obtain a TRUE or FALSE 
value. Any integer value may be used in a boolean context. 


cee A boolean expression uses relational and logical operators to manipulate 


Leonean 


ra TRUE/FALSE values. When a relational operator is evaluated, the result is alw ays 
: either 0 (FALSE) or FFFFH (TRUE). 


Possible Error Conditions 


Error 148, Integer value required 


Examples 
. 1. * To display the boolean value of FFH: 


JS00LSEF ere 
2 TRUE 


* 


2. To display the boolean vaue of an expression that includes logical and relavional 
operators: 


S800 SCS=DS@AND MIP AM Dice 


FALSE 


* 
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3. To display the boolean value of an expression that includes a symbol: 


150088 Ys ESE X o-EPeécro 


FALSE 


* 


Cl 


Display Stack—Display User Stack Contents 


The Display Stack command displays the contents of the user’s stack. 


Command Syntax 
STACK expression<cr> 


where 


expression is an integer expression, the value of which defines the number of 
words on the user stack to be displayed. 


Abbreviation 
STACK can be abbreviated to STA. 


Description 
The stack is located in user memory referenced by the pointer value SS:SP. The 
specified number of words are displayed from the top of the stack. 


Possible Error Conditions 


Error 148, Integer value required 
Error 126, Symbol does not eixst 


Examples 
1, Todisplay the contents of five words at the top of the stack: 


Ms TACKS <cr> 
WOR O839:0D0CCH=41700H 4342H 2045H 3D30H 6874H 


2. .To display the contents of n stack words, where n is the word value stored at 


SAM: ; : 
Wo tAMMS ANSTO 


EVALUATE—Display Integers in Five Bases ~ 


‘The Evaluate command displays integer values in binary, octal, decimal, hex- 


adecimal, and ASCII, and pointer values in pointer and 20-bit forms. 
Command Syntax , . | F 
EVALUATE expression [SYMBOLICALLY] <cr> 


where 


expression is an integer expression. ° 
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EVALUATE can be abbreviated to EVA, and SYMBOLICALLY toSYM. ~ 


SYMBOLICALLY is a keyword that displays each numeric value output by the 
command as as a symbol or a source statement, plus a remainder. The numeric 
value is assumed to be a pointer. If no symbol with a value less than the value 
being evaluated exists, it is displayed in pointer form. 


Abbreviation a 


Description 


The Evaluate command translates integers from one base to another and computes a 


20-bit address like that of a pointer. Any expression is evaluated to a single number 
and the result is displayed in binary, octal, decimal, hexadecimal, and ASCII bases. 


In the four numeric bases, the BYTE and WORD values have a suffix and sufficient 
leading zeroes to contain the following number of digits. 


Hexadecimal Decimal Ocial Binary 
(H) mM ({Q) (Y) 
BYTE ae < 3. 3 
WORD . 4 5 6 16 


In base ASCII, characters are enclosed in single quotes (’); printing characters 
(ASCII codes 20H through 7EH after bit 7 is masked off) are displaved, while non- 
printing characters are suppressed. 


If you specify the keyword SYMBOLICALLY, the system searches the symbol table 
for the symbol or statement number with the same base whose offset value is closest 
to but not greater than the value being output. If a symbol and a statement number 
have the same value, the symbol is used. The value is then displayed as either (sym- 
bol + numeric constant) or (statemént number + numeric constant), where the 
numeric constant is the non-zero remainder in hexadecimal base. If no symbol or 
Statement number has a value Jess than or equal to the value, it is output as a 


numeric constant. 


Possible Error Conditions 


Error 126, Symbol or line does not exist 
Error 137, Module does not exist 


. Examples 


1. To display the value of 4142H in the five bases: 


SEVAwIArerr> | 
1000001010000Y 405020 167067 4142H ‘AB! 


* 


2. -To display the value of FFH + ADH in five bases: 


NEVA SE FattmADSCY> 
110101100Y 654Q 428T 1ACH ',? 
* 


3. Todisplay 11 1:0222H as a symbol or statement number plus remainder: 
EVAR AAS D2e2SS SN KreS| 
0111:0222H 
* 


This example assumes that no symbol or statement number match. 


DEBUG-86 


eee : 
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4. To display 111:222H as a symbol or statement number plus remainder: 


JEVAMGdseecere. 


»-HODT.SAM + 0021H_ 
¢ . 


This example assumes that a matching symbol with an address at 111:201 has 
been selected. 5 


= Symbol Manipulation Commands 

The commands described in this section allow you to manipulate the symbols and 
Statement numbers in the DEBUG-86 symbol and statement number tables. With 
these commands, you create and change symbols, and display and remove symbols, 


modules, and source statement numbers. 


The Symbol Manipulation commands are: 


ae DEFINE Symbol Enters a new symbol in the table. 
Display Symbols Displays symbols and their values. 
Display Lines Displays statement jonibere and associated absolute 
: addresses. 
Display Modules Displays the names of all modules. 
Change Symbols Changes the value and type of symbols. 
Remove Symbois Removes specified symbols, or specified modules, or all 


modules, symbols, and statement numbers. 


Set Domain Establishes a default module for statement number 
references that do not contain a module name. 


Define Symbol—Enter New Symbol ‘ 


‘o | The Define Symbol command enters new symbols in the DEBUG-86 symbol table. 
Command Syntax ; 
DEFINE E..modulel.symbol = change-exp [OF memory-typel<cr> 


: where 


module is the name of an existing program module, in which symbol is to be 
located. The module is prefixed by two periods (..). 


ts “symbol is a user-defined symbol to be entered into the symbol table for use dur- 
ing the debugging session. The symbo/ references a location in the symbol table, 
and is prefixed by a period (.). 


change-exp is a numeric expression, the value of which is to be assigned to 
* symbol. The change-exp represents an address of statement labels or variables, 
or the value of a constant. 


OF memory-type specifies any of the following: BYTE, WORD, SINTEGER, 
INTEGER, or POINTER. If memory-type is omitted, symbol! has no type. 
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Abbreviation 
DEFINE can be abbreviated to DEF. 


Description 


The rules for defining new symbols are as follows: i 


-) 


a 


You can use up to 122 characters for the symbol name, of which the first 31 
characters must be a unique combination. 


The first character in the symbol name must be an alphabetic character, or one of 
the two characters @ or ?. The remaining characters can be these characters or 
numeric digits. 


You can specify the module that is to contain the new symbol. The module named 

must already exist in the table. The symbol is then placed in that module’s section of 

7 the table. Symbols defined without a module are placed in the unnamed module at 
Gs: the head of the table. 


The new symbol name may not duplicate a symbol name already present in the 
named module. However, the same symbol name may appear in different modules. 


Possible Error Conditions 


Error 125, Symbol already exists 
Error 137, Module does not exist 


Examples 


1. To enter the byte symbol .BEGIN in the symbol table module ..MAIN with a 
value of F3H: 


DEFANESS@MAINSBEGIN S—SF3 BD FAR YIE , 


; : 
GE * . , 
2. To enter the untyped symbol .CAR into the symbol table with a value of 
0000:0FOOH: : . 
JEP aSCARS—6000050F00<cr> 
& : . 
3. To enter the word symbol ENT! into the symbol table with a value of VAR + 
10: : : 
WOE F, 





4 


7 “4, To enter a pointer symbol .CAT2 into the symbol table with a value of 
0700:0050H: , ; 


— | +E SESE 
. : 
5. To enter a pointer symbol .CAT2 in the module ..SUBRA with a value of 
0000:00FOH: ; 


DEPTS UBRASCATZ£#—-BO000=00FORD FSP 0i<er> 
* , 
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Display Symbols—Display One or More Symbols 


The Display Symbols command displays one or more symbols (and modules if any). 


Command Syntax 


SYMBOL 
le iosutelepepet [.symbol] ‘| ad 


where 


SYMBOL is a command keyword that causes the entire DEBUG-86 symbol 
table to be displayed, module by module. 


module is the name of the program module in which symbol is located. The 
module is prefixed by two periods (..). 


symbol is the name of a symbol that references a location in the symbol table. 
The symbol! is prefixed. by a period (.). 


Abbreviation 
SYMBOL can be abbreviated to SYM. 


Description 


To display a value from the symbol table, enter the symbol name {and module name 
if any). If the symbol desired is the first occurrence of that symbol in the symbol 
table, you do not need the module name. The symbol table value is displayed on the 
next line. 


To display the entire symbol table, enter the command SYMBOL. Symbols are 
displayed module by module, starting with the unnamed module. Each module 
name is displayed at the head of that module’s symbols. The value corresponding to 
each symbol is also displayed. . 


Possible Error Conditions 


Error 137, Module does not exist 
Error 126, Symbol does not exist 


Examples 
1. To display the symbol .SAM: 
+E? 
- SAM=0200:317FE2H OF INT 
2. To display the symbol .SAM located in module .. MYPROG: 
4 SH YPROGSSANSIT>| 
~SAM=O0200:7FE2H OF INT 
3. To display the entire symbol table: - 
*ETECS 
-TEMP=0000.0001H 


MODULE ..MAIN 
-BEGIN=0800:0050H 


o sence = E 5 et emmninin ie ne cee ee acento oto 
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-VAR=0800:0100H OF BYT 
MODULE ..SUBR 
- «PROC=0800:0069H 
-X=0800:0101H OF WOR 


Le 


woe 


. Display Lines—Display Statement Numbers 


The Display Lines command displays the value of a single source statement number 
or all staternent numbers. 


Command Syntax 


LINE < p> 
{..modulel#fstatement-number . 


where 


‘LINE is a command keyword that displays all statement numbers and 
associated absolute addresses in the current domain. The module name is 
printed at the head of the module’s line numbers when displaying all lines. 


module is the name of the program module in which statement-number is 
located. It is prefixed by two periods. 


statement-number is the source statement number. It is a numeric constant with 
a default suffix that is always decimal. It is prefixed by a number sign (#). 


Abbreviation 
LINE can be abbreviated to LIN. 


Description 

* DEBUG-86 maintains a statement number table for PL/M-86 or PASCAL-86 pro- 
gram source codes. The statement numbers are assigned by the compiler. The 
address of the first instruction generated by each source statement corresponds to 
each source statement number in the table. 


_ When you issue the command, LINE, each module name is printed at ce head of 
the module’s line numbers. 


address, specify the statement number pkefixed by a number sign (#).1f two or more 
.. modules have.been compiled separately and contain the same statement numbers, 
‘specify the module name. . : 


To display the value of a angle aie Sete number and associated absolute 


DEBUG-86 does not allow you to change the address corresponding to an existing 
Statement number, or define any new statement numbers, or delete (remove) any | 
Statement numbers. 


. Possible.Error Conditions 


‘Error 137, Module does not exist 
Error 126, Statement number does not exist 
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Examples . 
1. To display the value from the number table of a single statement number: 
#1=0800:0050H 


2. To display the value from the number table of a single statement number 
contained in a particular module: =| 


Ld <SMAINSE2<Croe 
#2=0800:0057H 

3. To display the addresses of all the statement numbers in the statement number 
table: 
ET 
MODULE ..MAIN 
#1=0800:0050H 
#2=0080:0057H 
MODULE ..SUBR 
#1=1140:0012H 
#2=1140:0037H 
#3=1140:00DFH 


1 


Display Modules—Display Module Names 


The Display Modules command displays the names of all the modules currently in 
the DEBUG-86 symbol table. 


Command Syntax 
MODULE<cr> 


Abbreviation ° 
MODULE can be abbreviated to MOD 


Description 


‘To display the names of all the modules currently in the symbol table, enter the 


keyword MODULE. 


Possible Error Conditions 


None 


ve Example 


+ (ESS 
MODULE ..MAIN 
MODULE ..SUBR 
Change Symbols—Change Value of a Symbol 


The Change Symbol command changes the value (and memory-type if specified) of 
a symbol. 
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Command Syntax 


(..modulel.symbol{.symbol ...] «2. = ¢hange-exp [OF memory-typel<er> 
where 


module is the name of the program module in which symbol is located and is 
prefixed by two periods (..). a 


symbol is the name of an existing symbol that references a location in the sym- 
- - bol table. Each symbol is prefixed by a period (.). 


change-exp is a numeric expression of a pointer value to be assigned to symbol 
and represents either the address of statement labels or variables, or the value of 
a constant. 


OF memory-type specifies the memory type of symbol: BYTE, WORD, 
SINTEGER, INTEGER, or POINTER. If OF memory-type is omitted, the 
fete symbol’s memory type is not changed. . 


Abbreviation 


BYTE can be abbreviated to BYT, WORD to WOR, SINTEGER to SIN, 
INTEGER to INT, and POINTER to POI. 


Description 
The Change Symbol command replaces the value (and memory-type if specified) of 
a symbol. 


When the same symbol name exists in different modules, specify the name of the 
module containing the desired symbol. , 


= Possible Error Conditions 


Error 137, Module does not exist 
Error 126, Symbol does not exist 


_ Examples . : 
I. To change the value of a single symbol in the symbol table: 


4 AB CHS 000<cr> 


* 


2. To change the value and memory type of a symbol located in a particular 
module: 


| SBC RSS Es 


* 


ap be 


3. To replace the value of a symbol with the sum of the values of two other 
symbols, and change the memory type: : 


bd S33 MP AD Ct AT NSD ETS FAORD Scr: 
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Remove Symbols—Remove Symbols/Modules 


The Remove Symbols command removes one or more symbols, or one or more 
modules, or all symbols and lines from the DEBUG-86 tables. 


Command Syntax 


- {..module].symbol l.symbol...319 go ates . 
- REMOVE {SYMBOL - <er> 
MODULE ..module [,..module]... 


where 


module is the name of an existing program module in the symbol table, and is 
prefixed by two periods (..). Up to 19 modules can be listed at one time. 


& ° symbol is the name of an existing symbol in the symbol table, and is prefixed by 
a period (.). Up to 19 symbols can be listed at a time. 


SYMBOL is a command modifier that deletes the ent current DEBUG-86 
symbol table. 


MODULE is a command modifier that deletes all the symbols and lines of the 
named module from the symbol and statement number tables. ane object code 
is not affected. 


Abbreviation 
REMOVE can be abbreviated to REM, SYMBOL to SYM, and MODULE to MOD. 


Description 


ce To remove one or more symbols from the symbol table, use the first form of the 
command syntax. If the desired symbols occur in more than one module, specify the 
module name. The first occurrence of each symbol is deleted. 


To remove all modules, spaniels and statement numbers from both tables, use the 
second form of the command syntax. 


To remove a single module, use the third form of the command syntax. Removing a 
module removes all symbols and statement line numbers lines in the module, but 
does not affect the object code. 


-When more than one module is listed, separate them with commas. When more than _ 
. one sy mbol i is listed, separate them with spaces. 


ab ds. 


Possible Error Conditions 


Error 139, More than 20 symbols entered 
Error 137, Module does not exist 
Error 126, Symbol does not exist 
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Examples : 
1. To removea single symbol from the symbol table: 
REMOVE SBA SCecr> 
* 
2. To remove a symbol from a particular module: z 
BREMOVE SCeNAINSDEF Kcr, » % 
us ‘ : 


~ 3. Tosemove symbols from different modules: . 


REM OMT I SOP ARM AOMAIN STUD SOCARS PECARSISIOUBR I Xerr> 
* : ‘ 
4. Todelete both the symbol table and the statement number table entirely: 


WREMOVESSYHSOLKreS. 


£ 
. 5. To remove a single module from the symbol and statement number tables: 
ad REMOVERMODULE COPNASNCcr> 
a re . ; 


6. Toremove three modules from the symbol and statement number tables: 


REM aD DSEEMATN SESUBR SSCALTCrr> 


- 


Set Domain—Establish Default Module 


The Set Domain command establishes a specified module as the default module for 
statement number references. 


Command Syntax 
DOMAIN ..module<er> ; 


om where 


DOMAIN is a command keyword that establishes a default module for source 
statement number references. 


module is the name of an existing program module in the statement number 


table and is prefixed by two periods (..). 


Abbreviation 
- DOMAIN can be abbreviated to DOM. 


ay fs. 


Description 


This command establishes a default module so that you need not specify the module ° 
. tame each time you reference a statement number contained in that module. - 


When the domain is set, you need not use module names on statement numbers 
while debugging that portion of the program. 
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Possible Error Conditions 
Error 137, Module does not exist 


Example 
1. Toestablish the module ..MAIN as the default: 


NDOMAINSSEMATNEcr> 


* 


* 


AL 


| Compound Commands 


The compound commands described in this section enhance the operation of 
DEBUG-86 by extending the power of the simple commands. A compound com- 
mand is a control structure that contains zero or more commands. 


The compound commands are: 


REPEAT A looping command 
COUNT A looping command 
IF A conditional execution command 


The examples in this section are independent of each other. The introduction to each 
example gives the initial conditions for that example, and does not assume any 
results or conditions from any previous examples. 


REPEAT Command 


The REPEAT command executes zero or more DEBUG-86 commands in a loop; the 
loop can also contain zero or more logical conditions for termination. 


The REPEAT command. consists of the REPEAT keyword, zero or more com- 
mands of any type, zero or more exit conditions using WHILE or UNTIL, and the 
keyword END. Enter each of these elements on its own line of the console display. 
Terminate each input line with an intermediate carriage return (shown as cr in the 
command syntax). Terminate the last line, END, with a final carriage return to 
begin the sequence of execution. : 


Syntax 
REPEAT<cr> 


command<cr>- 
| wate boolean-expression<etr> |... 

UNTIL boolean-expression<cr> 
END<cr> 


Description 

After each intermediate carriage return, the system begins the next line with a period 
(giving an indented appearance), then the asterisk prompt to signal readiness to 
accept the next line. The END keyword can be entered as ENDR or ENDREPEAT; 
the characters after END serve as a form of ‘‘comment’’ to indicate. which loop is 
being terminated. 


The elements to be repeated are shown in brackets in the syntax. Each element can 


-beacommand, a WHILE clause, or an UNTIL clause. You can mix these elements 


in any order, using any number of each type of element. 
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Each command is executed when it is encountered on each iteration. After the com- 


_ mand has been completely executed, the loop proceeds to the next element. 


The WHILE and UNTIL keywords introduce exit clauses. The WHILE clause ter- 
minates execution of the loop when its boolean-expression evaluates FALSE. The 
UNTIL clause terminates the loop when its boolean-expression evaluates TRUE. 


In both the WHILE and UNTIL clauses, the boolean-expression is evaluated zach 
time the clause-is encountered; that is, once per iteration. Evaluation at each itera- 
tion involves looking up the values of any references in the expression. Thus, the 
result can change with each evaluation. 


The choice of WHILE or UNTIL is usually a matter of convenience—there is always 
a way to convert one into the other. For example, “WHILE bool-expr’’ is 
equivalent to ‘““UNTIL NOT (bool-expr)”*. 


NOTE 


To terminate execution of a REPEAT (or COUNT) loop, enter CNTL-D at 
the console. The DEBUG-86 command currently executing halts wherever it 
happens to be; if you are executing, the current instruction is completed 
before the break. DEBUG-86 responds to the CNTL-D character with the 
asterisk prompt. 


To return to RUN and then optionally to ISIS-II, enter CNTL-C. 


Here are some brief examples of the REPEAT command. 


Example 1. Generate an ASCII table similar to table 6-2: 


DEFINE .TEMP = 40H 
REPEAT 
WHILE .TEMP <= 7EH Pies tu ee hs sa wtilesyas nice oe sl 
EVALUATE .TEHP 
.TEMP = .TEHP + 1 : 
ENDR 


Example 2. Single-step through the user program for each instruction until a 
repetitious routine (. DELAY) is reached: 


REPEAT 
UNTIL CS:IP = .DELAY 
STEP 
ASK CS:1P 

ENDR 


Example 3. Using a complex combination of conditions in the boolean expression: 


REPEAT 
UNTIL COSsIP >-.END XOR .YAR1 = 0) OR (.TEHP > 0 XOR .YAR2 = 
STEP . , 

_ REGISTER 

ENDR 


. ‘Example 4. Execute from the start of the program (.START) until a breakpoint 
(. ERROR) is reached, display status-registers, then continue execution, and display- 


ing registers until a terminating condition (BYTE .VAR = 2) is reached: 


REPEAT 
60 TILL ERROR 
REGISTER 
UNTIL BYTE .VAR = 2 
ENOR 


DEBUG-86 
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COUNT Command 


Like REPEAT, the COUNT command sets up a loop. In addition to the WHILE 
and UNTIL clauses discussed under REPEAT, COUNT includes a loop counter that 
terminates the loop if no exit condition is met before the counter runs out. 


ALG 


The COUNT command has the form: 


COUNT arithmetic-expression<cr> 

: command<cr> 

: [ wrt bool ean-expressioncer> | Pret 
UNTIL boolean~expression<cr> 

END<cr> 


The arithmetic-expression after COUNT controls the (maximum) number of itera- 
tions to be performed. If a numeric constant is used (for example, COUNT 10), 
DEBUG-86 interprets it in implicit hexadecimal base; in other words, any number 

G5: sate after COUNT without an explicit radix is interpreted as a hexidecimal 
number. 


If the entry after COUNT is an arithmetic-expression, it is evaluated to give the 
number of iterations. The COUNT expression is evaluated once, before any loop 
elements are encountered. It is not evaluated again on any interation. The COUNT 
expression uses the values of any references it contains as they stand at the time of 
evaluation. For example, consider the following command sequence: 


DEFINE .XX = 2 
COUNT .XX 

“aXX = XX + 1 
END 


This loop goes through two iterations, although -XX has value 4 when the loop 
terminates. 


The loop terminates when the number of iterations given by the COUNT expression 
has been performed or when an exit condition is tested and causes exit, whichever 
comes first. The following example illustrates this concept. 


DEFINE .XX = 1 
COUNT 5 
XX = XX + 1 
WHILE kX <5 
END 


To show that the laop terminates on the WHILE condition before the COUNT 


expression is enriauss d, we can “‘track’’ the loop in operation. Table 6-9 shows the 
track. 


eT Table 6-9. Tracking a COUNT Command 


aybe 
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Conversely, the COUNT expression specifies the maximum number of iterations to 
be performed in case no exit clause produces an exit on any iteration. For example: 


COUNT 10T 
UNTIL CS:IP = .DELAY 
STEP 
ASM CS:IP 

END . 


UF 


wos 


In this command, the COUNT expression specifies a maximum of ten STEPs, in 
- case the first instruction at .DELAY is not reached during any iteration. 


With a REPEAT command or with a COUNT command that include one or more 
clauses, there may be no direct way to tell how many iterations occurred before the 
loop terminated. For these cases, you can insert a loop counter as a loop element. 
For example, to obtain table 6-9 as a display you could use the following sequence: 


BASE = T 
Faceesd DEFINE .ITER = 0 
tee DEFINE .XX = 1 
{ COUNT 10T 
oXX = .XX + 1 
elTER .= .ITER + 1 
-ITER 
XX 
BOOL .XX < 5 
WHILE .XX < 5 
END | 


The command BOOL .XX < 5 produces a display of TRUE or FALSE. 


The following example executes to a breakpoint, displays 8086 registers, then con- 
tinues executing, breaking, and displaying for 10 iterations: 


COUNT 10T 
GO TILL .PAUSE EXECUTED 
REGISTER 

END 


IF Command. 


The IF command permits conditional execution in a command sequence. The IF 
command has the form:. 


IF boolean-expression [THEN] <cr> 
[eommand<cr>] .... 


ORIF boolean-expression eas aes 
. [command<cr>] ... 


* TELSE<er> 
= [commnand<cr>] vw 
~ END<cr> OO 


The command must have the IF clause; the ORIF and ELSE clauses are optional. 
The command can include as many ORIF clauses as desired. The IF and ORIF 
clauses each contain a single condition (boolean expression). Any clause can contain 
none, one, or more commands. A clause with no commands simply produces an exit 
when its condition is TRUE. 
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DEBUG-86 examines each boolean expression in turn, clause by clause, looking for 
the firsts TRUE condition. If a TRUE condition is found, the commands in that , 
clause are executed and the IF command terminates. If none of the conditions is 
TRUE, the commands in the ELSE clause are executed and the IF command (er- 
minates. If the ELSE clause is omitted and no condition is TRUE, the IF command 
terminates with no commands executed. 


The END keyword is required to close off the IF command; it can be written as 
ENDIF to clarify nesting. ; 


The following is an example of the IF command. 


Ip = 
IF IP < 1 
EVALUATE 1 
ORIF IP < 2 
EVALUATE 2 
ORIF IP < 3 
EVALUATE 3 
ELSE é 
EVALUATE 4 
END 








This example displays the result of EVALUATE 2 and then terminates. The first 
condition (IF IP < 1) is FALSE, so EVALUATE 1 is skipped. The second condition 
(ORIF IP < 2) is TRUE, so EVALUATE 2 is executed and the IF command ter- 
minates. The third condition (ORIF IP < 3) is not tested, even though it happens to 
be TRUE. 


In practice, however, the IF command is useful when it is nested in a REPEAT or 
COUNT loop rather than appearing at the top Jevel. A nested IF command enables 
you to test conditions that can change (due to other commands in the loop), whereas 
when an IF command is at the top level the TRUE or FALSE state of any condition 
is known, or can be determined with the BOOL command. Thus, the result from the 
previous example can be obtained with fewer steps: 


BOOL IP <1 (Displays FALSE) 
BOOL IP <2 (Displays TRUE) 
ee EVALUATE 2 ee 


Nesting Compound Commands 


The REPEAT, COUNT, sad IF commands can be nested to orovide a variety of 
control structures. 


Each nested compound command must have its own END keyword. When entering 

a nested command sequence, you may wish to use the keywords ENDR, ENDC, and 

.. ENDIF to help you keep straight which command you intend to close off. 

‘  -. DEBUG-86 does not check nesting levels at entry, and-if an END is omitted, the 
:  ° resulting error makes it necessary to enter the entire command again. 


ot 


Each nested REPEAT ‘or COUNT command can contain its own exit clauses 
- (WHILE or UNTIL). Each exit clause can terminate the loop that contains it, but 
has no effect on any outer Joops or commands. 


As an example of nesting, suppose you want to STEP through a program with 
disassembled display, but skip a repetitive timeout routine, .DELAY, that is called 
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with an 8086 short-call instruction several times during program execution. One way 
to achieve this effect is with the following command sequence: 


REPEAT 

If CS:IP = .DELAY é 

_1P = WORD SS:SP 

SP = SP + 2 

ENDIF ; : 

- STEP 7 
ASM CS:IP 

ENDR 


an oe 


‘be 


At each call to .DELAY in the program, the displacement of the return address for 

the call is pushed on the stack. The keyword SP refers to the stack pointer, and SS is 

the stack segment register; SS:SP is the address of the top of the stack where the 

return address is stored. The effects of the commands IP = WORD SS:SP and SP = 

SP + 2 are to load the return address back into IP and reset the stack pointer just as 
tt if the return instruction at the end of .DELAY had been executed. 


As another example of nesting, suppose the user code at statements #21 and #22 is 
incorrect or not written yet. The following sequence executes to the point where 
substitute code is to be inserted, inserts the code (equivalent to IF MARK >0 THEN 
PTR = PTR +2 in PL/M), then continues executing beginning with statement #23 
(the insertion is made any time execution reaches statement #21): 


GO FROM .START TILL #21 
REPEAT 
IF WORD .MARK > 0 
WORD .PTR = WORD .PTR + 2 
ENOIF 
GO FROM #23 
ENDR 


An exit can be made only when a condition is tested, not when it occurs. To cause an 
exit, the test must be placed at the point in the loop where the condition occurs. For 
example, consider the following command sequence: 


€ REPEAT 7 
UNTIL IP = 1000H 
: STEP. j 
ENOR 


In this command the condition IP = 1000H is tested. after. every STEP. If the 
sequence of STEPs reaches IP = 1000H as the next instruction, the loop will ter- 
minate. By contrast, consider this example: 


REPEAT 
UNTIL IP = 1000H 
ie COUNT 10 
wey TY STEP 
,. *e _ENDEC 
-ENDR | 


In the second example, the condition IP = 1000H is tested after every ten STEPs. 
The loop exits only if IP = 1000H occurs at the end of some group of ten instruc- 
tions. If IP = 1000H occurs during one of the groups of ten STEPs, the loop does 
not terminate because that condition is changed by subsequent STEPs before the test 
can be made. 
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If the command has more than one exit clause, each exit clause is tested when it is 
encountered. If the result at the moment of the test causes an exit, the loop ter- 
minates; otherwise, the loop proceeds to the next element. 


The loop exits only when the current test causes it, even though some other clause in 
the loop would cause an exit if it could be tested at that moment. Consider this (arti- 
ficial) example: 
DEFINE .ZZ = 0 - 
Cs = 780 
IP-= 0 
REPEAT ; 
UNTIL IP > 10H 
COUNT 5 
STEP 
ENDC 
ASM CS:IP 


Assume for this example that the code being executed (with STEP) contains only 
two-byte instructions. Then, after the first time through the loop, IP = OAH (10T) 
and .ZZ = 1. On the second iteration, the test IP > 10H is FALSE when it is 
encountered, so the STEP and ASM commands are executed again. At this point, IP 
> 10H is TRUE but since it is not tested, no exit occurs. Instead, the condition .ZZ = 
0 is tested, found to be false, and the loop exits. 


CHAPTER 7 


ERROR MESSAGES 





This chapter lists the error messages issued by ISIS-H, RUN, PERU Goo and 
nonresident system routines. = 


Error message numbers are allocated as follows: 

: © 1-99 inclusive — ISIS-II resident routines (8080/8085 mode) 

® 100-119 inclusive — RUN command (8086 mode) 

® 120-199 inclusive — DEBUG-86 (8086 mode) 

® 200-255 inclusive — nonresident system routines (8080/8085 mode) 


The following manual is referred to in this chapter as “reference 1”’: 


ce 
i Intellec Series III Microcomputer Development System Programmer's 
Reference Manual 

ISIS-II Error Routines (8080/8085 Mode) 
Errors encountered by ISIS-]I are either fatal or nonfatal. In the following lists fatal 
errors are noted as such. The other errors are generally nonfatal unless they are 
issued by the CONSOL system call (see tables 7-1] and 7-2). 
A nonfatal error immediately halts processing and permits your program to take a 
recovery path of your choosing. The error number is returned to your program. 

’ If an error occurs when you are entering a console command, the error is echoed 
followed by an error nese ee: For example, the following input results in the error 
message shown: : 

wCOPY4e PRSCRED ITS D we FI=KCRD 
sPR:CREDIT, UNRECOGNIZED DEVICE NAME . ' 


A fatal error immediately halts processing but does not permit recovery. Control 
returns to ISIS-I] which overlays some user program area with nonresident ISIS-I] 
files, and displays the following error message: 


ERROR nnn USER PC mmm 


where nnn is the error number and mmmm is the contents of the program counter 
when the error occurred. 


In general, after displaying an error message, the system displays the ISIS-I] prompt 
... character (a hyphen) and waits for you to enter the corrected input. 


The action taken in response to fatal errors depends on the setting of an internal 
_ system switch called the debug toggle. That switch indicates whether control is to 
return to ISIS-II (debug=0) or the Monitor (debug=!) when an error occurs. 


Any of the following actions sets the debug toggle to one and transfers control to the 
Monitor: 


e Pressing interrupt switch 0 while a program is running. 
® Executing program load with the DEBUG switch specified in the command line. 
® Executing a LOAD system cail with a transfer value of 2. 
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Any of the following actions sets the debug toggle to zero, performs the operation 
listed, then transfers control to ISIS-II: 


© Pressing interrupt switch 1 while a program is running. This action terminates 
processing. 
e Executing an EXIT system call. This action terminates a program. 


® Executing a LOAD system call with a transfer value of 1. This action load an 
absolute object file. : ae 


@ Executing a Monitor G8 command. This action exits the Monitor. 


If the debug toggle is zero when a fatal error occurs, the following occur: 

e Allopen files are closed in their current state, including :CI: and :CO:. 

@ The initial system console device is opened as :C]: and :CO:. 

® A fresh copy of ISIS-II is read in from the disk, and ISIS-]H prompts for a 
és: command with a hyphen (-). 


If the debug toggle is set to one when a fatal error occurs, the following occur: 
® All open files are left open. : 

@ Control passes to the Monitor. 

© Monitor prompts for a command with a period (.). 


At this point Monitor commands can be used to examine registers and memory to 
try to determine the cause of the error. However, the program should not be 
restarted with a simple Monitor G command, because the ISIS-II] restart address has 
not been saved. DO NOT RESET THE SYSTEM AT THIS POINT. A G8 com- 
mand should be used instead so all files are closed. Rebooting does not close files. 


. 


NOTE 


Although programs cannot be loaded in the ISIS-II area, the ISIS-I] area is 

not protected from a running program. If a program should happen to 

: destroy parts of ISIS-I1, subsequent system calls may not operate correctly 

SS and input/output may destroy areas on your disk. This would happen 

( mainly when an undebugged program is running. ISIS-II can always be 
restored by bootstrapping from a good system disk. 


Table 7-1. Nonfatal Error Numbers Returned by System Calls 


OPEN 3, 4, 5, 9, 12, 13, 14, 22, 23, 25, 28. 
READ __ 2,8. 
WRITE ; 2, 6. 
SEEK 2, 19, 20, 27, 31, 38. 
F - RESCAN is 

CLOSE aa J 
DELETE 4, 5, 13, 14, 17, 23, 28, 32. 
RENAME 4, 5, 10, 11, 13, 17, 23, 28. 
ATTRIB 4,5, 13, 23, 26, 28. 
CONSOL ~~. None: all errors are fatal. 

ib WHOCON None.. 
ERROR None. 
LOAD ~ . 3, 4, 5, 12, 13, 22, 23, 28, 34. 

‘EXIT None. : 

SPATH : 4,5, 23, 28. 
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‘Table 7-2. Fatal Errors Issued by System Calls 


OPEN 1, 7, 24, 30, 33. 

READ 24, 30, 33. 

WRITE 7, 24, 30, 33. 

SEEK _ 7, 24, 30, 33. k 

RESCAN 33. = 

CLOSE 33. 
_ DELETE 4, 24, 30, 33. 

RENAME. 1, 24, 30, 33. 

ATTRIB 1, 24, 30, 33. 

CONSOL 1, 4, 5, 12, 13, 14, 22, 23, 24, 28, 30, 33. 

WHOCON 33. 

ERROR 33. 

LOAD 1, 15, 16, 24, 30, 33. 
SPATH 33. 


ISIS-II error messages codes are: - 


J 
* 


ag 


10. 


Fatal error. The memory area from 3000H to program origin is used for 
input/output buffers. Too few buffers were allocated to meet the current 
request in addition to earlier requests. See reference | for information on how 
to allocate buffers. 


legal AFTN argument. The number supplied as an AFTN (active file table 
number) is inappropriate. Perhaps your program closed a file prematurely and 
then tried to read it. Active file table numbers are described in reference 1. 


Fatal error. AFT (Active File Table) is full. At most, six files may be active at 
one time. You must close one of your open files before a file can successfully 
be opened. (Reference 1) 


. Incorrectly specified filename. You have possibly entered too many characters 


for filename, as in OLDFILE.1 (the maximum is six characters before the 
period, three after). Filename conventions are described in Chapter 3. 


. Unrecognized device name. You have entered an incorrect device name, as in 


:PR: for the line printer :LP:. Check the device names in Chapter 3. 


. Attempt to write to input device. An attempt has been made to write to an 


input device. You can only write to an output device, such as a line printer 
(:LP:). See Chapter 3 for information on devices. 


Fatal error. The disk is full. Check that you have specified the intended disk. 


. Attempt to read from output device. Some devices, like the line printer (:LP:), 


are output only and cannot be read. The current operation either should not be 
a READ or needs to use a different device name. See Chapter 3 for devices. - 


Disk directory is full. There is no room on the target disk’s directory to add an’ 
additional filename. The limit is 200 entries for flexible disks and 992 entries 


for hard platters. 


Pathname is not on same disk. A system call was attempted (RENAME) that 


requires two pathnames on the same device but the specified pathnames did 
not specify the same device. (Reference 1) 


. File already exists. A filename identical to the one just used was found. 


Perhaps a different drive was intended, or a different spelling of the filename. 


File is already open. Only console input (:CI:) and console output (:CO:) may 
be opened multiple times. If the spelling of the filename is correct, a flaw may 
exist in the program logic. For example, an earlier module may be using the 


file too soon or there may be an unintended loop. 
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13. 


14. 
15. 
16. 


17 


. 


18. 


19. 
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No such file. The specified filename could not be found in the directory on the 
disk in the drive indicated by your command. A different drive or disk may 
have the file. For example, a console request to load a RUN file with a default 
extension of .86. 

Write-protected file encountered. The intended operation (e.g., WRITE, 
RENAME, DELETE) could not be done because the specified file has the 
write-protect or format attribute set. é 
Fatal error. ISIS overwrite. The system detected an attempt to write into the 
area reserved for the ISIS resident files, i.e., below 3000H. Such an operation 
-would create unpredictable results and is disallowed. 


Fatal error. Bad load format. This error was possibly caused by a 
source-language file. Files to be loaded for 8080/8085 execution must be in 
absolute object module format. 

Not a disk file. An attempt was made to reference a disk file on a wrong device 
type, with an improper pathname, such as :HP:FILE2 instead of :Fn:FILE2. 
File accessing conventions are described in Chapter 3. 


Wegal ISIS commands. This error results when an ISIS system call is made 
with an illegal command number. 


Attempted seek on non-disk file. Seeks on physical devices other than disk 


- drives are invalid (:BB: is an exception and is valid). (Reference | gives in- 


20. 


Als 
22. 


23 


“aa. 


formation on the SEEK system call.) 


Attempted back seek too far. The seek attempted to go beyond the beginning 
of the file; MARKER is set to zero. (Reference 1) 


Can’t rescan. The file was not opened for line-editing. (Ref erence 1) 


Illegal access mode to open. Only 1, 2, and 3 are valid, meaning input (read), 
output (write), or update (both read and write). (Reference 1) 


Missing filename. The system expected a filename, but one was not supplied. 


Fatal error. Disk input/output hardware error. When error number 24 occurs, 
an additional message is displayed: 


° 


STATUS=00nn 
D=x T=yyy S=z2z 


where x represents the drive number, yvy the track address, zzz the sector - 
meGresss and where nn has the following meanings: 


For flexible disks: © 
' 01° Deleted record 
02 Data field CRC error 
03 Invalid address mark 
04 Seek error 
08 Address error 
OA ID field CRC error 
0E No address mark 
OF Incorrect data address mark 
10 Data overrun or data underrun 
20 Attempt to write on Write Protect 
40 Drive has indicated a Write error 
80 Drive not ready 
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pasate: 


Maeee 


27 


23 


25 


26 


e 


28. 
29. 


30 


e 


cake 


32. 


33% 


34 


For hard disks: 


01 ID field miscompare 

02 Data field CRC error 

04 Seek error : 

08 Bad sector address 

0A 1D field CRC error 

0B Protocoi violations 

oc Bad track address 

OE  NoiD address mark or sector not found 
- OF Bad data field address mark 

10 Format error 

20 Attempt to write on write-protected drive 

40 Drive has indicated a write error 

80 Drive not ready 


oe 


Megal echo file. An echo file must have an active file table number (AFTN) 
between 0 an 255, and must already be opened for output. Check that these 
conditions are met. (Reference 1) 


Mlegal attribute identifier. This error refers to the second Parameter to the 
ATTRIB system call routine. Check that you have specified a valid parameter. 
Only 0, 1, 2, or 3 is valid, meaning the invisible, system, write-protect, or for- 
mat attributes, respectively. (Reference !) 


Illegal seek command. An unsupported mode for the specified device was used 
in a seek command. (Reference 1) 


Missing extension. An expected file extension was not supplied. 


Fatal error. Premature EOF. An unexpected end of file was encountered from 
the console. . 


Fatal error. Drive specified was not ready. 
Can’t seek on write only file. Seeks can be executed only on read or update 


files. (Reference 1) 


Can’t delete open file. You need to close the file before atiempting to delete it. 
Verify the pathname. (Reference 1) 


Fatal error. Illegal system call parameter. A parameter was specified in a 
system call which is meant to be used as a pointer to a memory area intended 
for the receipt of data; however, ISIS found that this pointer was pointing to 
the memory space which ISIS occupies. ISIS will not allow a user to write into 
its memory space. (Reference 1) : 


Fatal error. The return switch in a LOAD system call was not 0, 1 or 2, the 
only valid values. (Reference.1) : 


Seek past EOF. An attempt was made to extend a file opened for input by 
seeking past end-of-file. (Reference 1) 


. 
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RUN Program Error Messages 
(8086 Execution Mode) 


When an error oceurs under the RUN program, both the error number and the error 
message are displayed. Processing halts and control returns to the RUN program. 
The system displays the RUN prompt (>) and waits for you to enter a new 
command. ; : 


- Errors 117 through 119 are warnings. The system displays - warning message ‘and 
processing continues. 
101. HARDWARE NOT RESPONDING (fatal error) 

8086 hardware is not present or is malfunctioning. 


102. INVALID SYNTAX 
RUN does not understand your request. Check the input line and re-enter. 


ey 103. COMMAND LINE TOO LONG 
\ - The RUN activation line exceeds 120 characters. 


104. INSUFFICIENT MEMORY TO LOAD 
The loader does not have enough memory to load the requested object file. 


105. MISMATCHED SOFTWARE/FIRMWARE 
The version of RUN does not correctly operate with the 8086 firmware. 


107. ILLEGAL LOAD ADDRESS 


Loader tried to load a user program into 8086 system memory. Gale 8086 
memory begins at 7800H. 


108. INVALID OBJECT FILE 
The file specified ina LOAD command is not a valid object file. 


117. UNRESOLVED SYMBOLS (warning) 


cog The file just loaded contains externals that were not satisfi A at link time. The 
file was loaded correctly except for references to the unsatisfied externals. 


118. RAM FAILURE (warning) 
RAM failure was detected on the 86 processor board. 


"119. ROM CHECKSUM ERROR (warning) 
ROM checksum error was detected on the 86 processor board. 
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DEBUG-86 Error Messages (8086 Execution Mode) 


When an error occurs under DEBUG-86, the system displays the error number only, 
as follows: 


ERROR xxx 


petite 


where xxx is a decimal error number. | 


- After the error number, the system displays the DEBUG-86 prompt (*) and waits for 
you to enter a new command. 


The following list defines DEBUG-86 error numbers: 
120. Syntax error. The command line entered does not conform to the defined 
syntax. 

121. Invalid token. The command line contains a token that does not follow the 
i rules for a well-formed token. 
= 122. No such line. The specified line number does not exist in the current module. 

123. Inappropriate number. The value entered is not appropriate in the current 
context. 
Partition bounds error. The partition values entered in a command are not 
correct. Either the left part of the partition is greater than the right part or the 
values of the partition extremes are out of range in the current context. 
125. Symbol already exists. The symbol entered in a DEFINE command is already 

defined in the symbol table. 


126. Symbol does not exist. The sympa! referenced does not reside in the symbol 
table. 


127. Memory failure. Data written to memory was not correctly read back. This 
error can be caused by writing data into non-existent or bad memory. 


133. Null string error. A null string was used where a non-null string is required.. 
134. Memory overflow. Memory requirements of all dynamic tables exceed the 
amount of memory available. This error can be caused by an object module 
with too many symbols or line numbers. : 
135. Stack overflow. The capacity of'a statically allocated stack internal to the , 
Pe 2% diagnostic program has been exceeded. . 
136. Command too complex. The command complexity requires more memory 
than can be allocated. 
137. Module does not exist. The specified module does not exist in the symbol 
table. 
139. Excessive data. The amount of data to be inserted into a partition exceeds the 
size of the partition. : 
141. Unsuitable execute file. The file referenced in an execute command either 
contains code that is out-of-bounds for the execute command, or it is a main 
, °.  ,module. 


"142. Line too long. The command line was longer than 120 characters on a line. 


143. Too many partitions. da of partitions entered exceed the acceptable 
maximum of 19. 

147, Pointer value requized: A non-pointer valve was used in a context that requires 

- a pointer. 
148. Integer value required. A non-zero base value was used in a context that 
- "requires an integer. 

149. Differing bases. Two pointers with different bases were used in a context 
where pointers with the same base are required, e.g., the lower and upper 
bounds of a partition. 


124 
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Console Command Interface Errors 
(8080/8085 Execution NViode) 


201. nnceoenized switch. Certain predefined switches (e.g., P, S, A, U, C) can be 
used depending on the ISIS-II command. Some commands that have switches 
are IDISK, FORMAT, and COPY. Check the specified command i in Chapter 
4. : 

202. Unrecognized delimiter A character was eneounteaea hak was invalid“in a 

- name and not known as a delimiter. 


203. Invalid syntax. There is an error in the command as entered. The error may be 
an unrecognized keyword or a missing comma, for example. 


206. Mlegal disk label. The label supplied violates the rules for a valid disk label. 


208. Checksum error. The bits of the records read do not add up properly. An 
inappropriate input or medium was supplied. There may be an error in the 
internal format of the specified file that may have occurred during translation 
or linking. Retranslate and relink the source module. 


“= 209. Relo file sequence error. An inappropriate input file was specified. 

210. Insufficient memory. The required amount of RAM is not present. 

211.. Record too long. A record longer than allowed was encountered. 

212. INegal relo type. Relocation types must conform to Intel standard formats. 


213. Fixup bounds error. The required address violated numeric bounds on 
addresses. 

214. Wegal SUBMIT parameter. An error was made in the actual parameter to be 
substituted for a formal parameter in a command sequence file: (See the 
SUBMIT command in Chapter 4.) 

215. Argument too Jong. The number of characters in the actual argument must not 
exceed 31. 

216. Too many parameters. More parameters were supplied than defined. 

217. Object record too short. This error may be caused by an I/O error in the file to 

'  ° be loaded. 
218. Illegal record format. The record format did not match the Intel standard. 
a 219. Phase error. The expected phase input (e.g., for the next step of a translation 
a process) was not correctly supplied. 
220. No end-of-file record in object module file. There is an error in the internal 
format of the specified file. Retranslate and relink the source module. 
221. Segment overflow during LINK operation. The output segment cannot be 
greater than 64k bytes. \ 
222. Unrecognized record in object module file. There is an error in the internal 
format of the specified file. Retranslate and relink the source module. 
223. Fixup record pointer is incorrect. There is an error in the internal format of the 
specified file. Retranslate and relink the source module. \, 
. |. 224 Wegal record sequence in object module file in LINK. There i is an erron in the 
internal format of the specified file that may have occurred during translation. 
Retranslate and relink the source module. 


225. Wegal module name specified. An illegal or’ misspelled module name was 
. entered. 
es 226. Module name exeeds 31.characters. Module names exeeding 31 characters may 
not be used. 


227. Command syntax requires left parenthesis. There is a missing left parenthesis 
in the command line. Re-enter the command correctly. 
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228. Command syntax requires right parenthesis. There is a missing right 
parenthesis in the command line. Re-enter the command correctly. 


229. Unrecognized control specified in command. A character string other than the 
expected control keyword was entered. Enter the correct control keyword. 


230. Duplicate symbol found. You have attempted to add a symbol that already 


exists. i 
231. File already exists. The file specified ina CREATE command already exists: 
: 232. Unrecognized command. An illegal or misspelled command was entered: 


233. Command syntax requires a TO clause. The command syntax requires a TO 
clause to specify the output file. 

234. Filename illegally duplicated in command. The same filename is specified both 
as an input and output file. 

235. File specified in command is not a library file. The specified file is not a library 
file. 

236. More than 249 common segments in input files. You cannot have more than 

eae 249 common segments. 

237. Specified common segment not found in object file. The input module does 
not contain the common segment specified in the command. 


238. legal stack content record in object file. There is an error in the internal 
format of the specified file that may have occurred during the translation and 
link process. Retranslate and relink the source module. 


239. No module header in input object file. There is an error in the internal format 
of the specified file. Retranslate and relink the source module. 


240. Program exeeds 64k bytes. The output module to be placed in the output file 
exeeds the maximum of 64k bytes. 


Other Console Command Interface Errors 


Additional 8080/8085 link and locate error messages are described in the 
MCS-80/85 Utilities User’s Guide for 8080/8085-Based Development Systems. 


All 8086 mode link and locate error messages that may occur during LINK86, 


cae LOC86, OH86, and LIB&86 operations are described in the iAPX Family Utilities 
User's Guide for 8086-Based Development Systems. 


APPENDIX A 


HEXADECIMAL PAPER TAPE FORMAT 





Object code is stored on paper tape in an ASCII representation of the program in 
_ memory. The code is blocked into records, each of which contains the record type, 
“length, type, memory load address, and checksum in addition to the data. Figure 
A-l shows the frames of a tape record. 





CHECKSUM 


DATA 


‘Youewas 


RECORD TYPE 
LOAD 
ADORESS 


RECORD 
LENGTH 


RECORD MARK 


Figure A-1. Paper Tape Record Format 
rte entennnnneeeennnesneneeentt 
CEE The Record Mark is a colon (3AH) and is used to signal the start of a record. 


__ The Record Length is the count of the data bytes in the record. A record teugin of 
- zero indicates end-of-file. : 


The Lose Address specifies the address at which the first data byte will be loaded. 
. The successive data bytes will be stored in successive memory locations. 


The Record Type specifies the type of this peer Gs All data records are type 0. End-- 
of-file records can be type 0 or I, 


The Data consists of two frames per memory word. The data is represented by hex- 
‘ _adecimal values 00H through FFH. 


The Checksum is the negative of the sum of all 8-bit bytes in the record, beginning 


with the Record Length and ending with the last Data byte, evaluated modulo 256. 
The sum of all bytes in the record (including the checksum) should be zero. 


Av] 
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HEXADECIMAL- DECIMAL CONVERSION 





. The following table is for hexadecimal to decimal and decimal to hexadecimal con- 
version. To find the decimal equivalent of a hexadecimal number, locate the thex- 
adecimal number in the correct position and note the decimal equivalent. Add the 
decimal numbers. ; 


To find the hexadecimal equivalent of a decimal number, locate the next lower 
decimal number in the table and note the hexadecimal number and its position. Sub- 
tract the decimal number from the table from the starting number. Find the dif- 
ference in the table. Continue this process until there is no difference. 


| BYTE BYTE 


HEX DEC HEX DEC HEX DEC HEX 
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0 
1 
2 
3 
4 
5 
6 
7 
8 
9 
A 
B 
Cc 
dD 
E 
F 
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ASCII CODES 





Table C-1. ASCII Code List 


: 000 00 64 100 40 
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# 
$ 
%. 
& 
( 
: 
+ 
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ASCII Codes 
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NULL Character 
Start of Heading 
Start of Text 

End of Text 

End of Transmission 
Enquiry 
Acknowledge 

Bell 

Backspace 
Horizontal Tabulation 
Line Feed 

Vertical Tabulation 
Form Feed 

Carriage Return 
Shift Out 

Shift tn 

Data Link Escape 
Device Control 1 
Device Control 2 
Device Control 3 
Device Control 4 
Negative Acknowledge 
Synchronous Idle 
End of Transmission Block 
Cancel 

End of Medium 
Substitute 

Escape 

File Separator 
Group Separator 
Record Separator 
Unit Separator 
Space 

Delete 


Table C-2. ASCII Code Definition 
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APPENDIX -D 
SUMMARY OF ISIS-II 






CONSOLE COMMANDS 


This appendix provides a summary of command syntax for ISIS-II commands... 


Disk Maintenance Commands 


IDISK—Disk Formatting Command 

IDISK :fnilabel ([switches)<cr> = 
where 

Jabel is the name to be given to the blank disk. 

switches are one or more of the following: 

Ss Formats the new disk as a basic system disk. 

P Specifies single drive mode. 

FROM n Specifies the disk dave containing the source disk files needed for 

formatting the new disk. The value n is an integer 0-9 for drive 


numbers 0 through 9. If the FROM n switch is not specified, the 
default is to drive 0. 


FORMAT—Disk Formatting Command 
FORMAT sFnilabel (switches]<cr> 
where 
label is the name to be given to the disk. 
switches are one or more of the following: 


A Copies all files to the specified disk except files (other than ISIS-II 
; system format files) with the format attribute set. 


Ss Copies the basic format files and all files with the system attribute set. 
FROM n Specifies the disk drive containing the disk files needed for. 


formatting. n is an integer 0-9, for drives 0 through 9. If the FROM n 
switch is not specified, the default is to drive 0. 


FIXMAP—Hard Disk Mapping Command 
FIXMAP drive<cr> 
where 


drive is the number of the hard disk drive on which the command is to operate; 
drive is an integer value of O or 1. 
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FIXMAP Commands _ 


Mark disk-address Change the known state of a sector from good to bad. 
Free disk-address Change the known state of a sector from bad 10 good. 
List filename | List all known bad sectors. 

Count List the number of known bad sectors. 

Record Record changes specified by Mark and Free. a 
Quit Exit to ISIS-II without recording changes. = 
Exit . Record changes and exit to ISIS-I1. 


A disk-address takes the form: 


track,sector(T] 
where 


track is a number from 0 to 199 that specifies the logical track address contain- 
oe ing the bad sector. 


bascewe 


sector is a number from 1 to 144 that specifies the logical sector address of the 
bad sector within the track. 


T is an optional switch indicating that a group of 36 sectors should be processed. 
File Control Commands 


DIR—Disk Directory Listing 
DIR [FOR filenamel(TO listfilellswitchesl<cr> 
where 


filename is the file (or group of files specified with the wild card construction) 
whose directory entry is to be listed. 


ant: Switches are one or more of the following: 


0-9 Lists the directory of the disk in :FO:, :F1:, .iF9:. 
Lists all files, including files with the Boe Ap set. 
Gives fast output, listing only filenames. 
Prints the directory in a single column format. 
Prints the number of sectors presently used. 
Specifies single drive mode. 


uwNOM™ 


COPY—Copya File 


oo COPY Ciknilinfile €,...J ie 


: ite <cr> 
baggree: [switches] cr 


where 
infile is a file (or group of files when using the wild card construct) to be copied. 
outfile is a file to be created or recreated. 


device: is an output device, such as :LP:, :TO:, :HP:, or :CO: 
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focwwen 


switches are one or more of the following: 


Copies files with the system attribute set. 

Copies files without the system or format attribute set. 

Specifies single drive mode. 

Specifies the query mode. 

Creates outfile with the attributes set from the infile. 

Deletes an existing file without displaying the “ALREADY 
EXISTS” prompt. 

Opens outfile for update instead of deleting it. 


‘cq wnouvuzrn 


HDCOPY—Copy Hard Disk Tracks 


indrive 10 outdrive 
HDCOPY BACKUP ere 


where 
indrive is the number of the drive containing the source hard disk. 
outdrive is the number of the drive containing the destination hard disk. 


Both drive numbers must be 0 or 1, but both cannot be the same drive number. 
Both drives must be a hard disk drive. 


BACKUP is a switch that can be used to backup a removable hard disk platter. 


DELETE—Delete a Disk File 
DELETE C:Fn:lfilename [Q] [, . . . [@]] [Pl]<cr> 


' where 


filename is the name of a file to be deleted. The wild card construction can be ~ 


used to delete a group of files. 


Q Specifies the query mode.” 
Pp. Specifies single drive mode. 


_RENAME—Rename a Disk File 


RENAME = Fns loldname TO [:Fn: haegnanecers. 


w here" 


_ Fn: must be the same for both o/dname and newname. 


oldname is the name of an existing file whose write-protect or format attribute 
is not set. - 


newname is the new name to be assigned to oldname. 
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ATTRIB—Change/ Display Disk File Attributes 
ATTRIB [:fn:lfilename Cattriblist} (al<cr> 
where 


filename is a disk file whose attributes are to be changed. The wild card ‘con- 
~ struction can be used to change and/or display the attributes of a group of files. 


attriblist is one or more of the following: 


= l0or ll Resets (10) or sets (11) the invisible attribute. 
WO or Wi Resets (WO) or sets (W1) the write-protect attribute. 
FO or F1 Resets (FO) or sets (F1) the format attribute. 
SO or S1 Resets (SO) or sets (S1) the system attribute. 
Q Specifies query mode operation. 


8080/8085 Program Execution Commands 
Filefme 


— Direct Program Execution 
pe RC. 


parameters] 


En 


its 













where 


parameters are parameters needed by_progname. 


DEBUG—Transfer Control to Monitor 
“DEBUG [CL:Fn:] filename (parameters))<cr> 
ess where 
filename is any ISIS-I1] command or the file name of an executable program. 


" parameters are the normal parameters of the program to be executed. 


SUBMIT—Non-Interactive Program Execution 
SUBMIT (:Fn:lfilenamel(parameter{, . . .1)9]<cer> 
\ where 
filename is the name (and extension, if any) of the file containing the command 
sequence definition (explained below). If extension is omitted, SUBMIT 
“assumes the default extension .CSD. 
* parameter is an actual value that is to replace a formal parameter in the com-- 
mand sequence definition file. The maximum number of parameters allowed is 


10. If you omit a parameter from the SUBMIT list, enter a comma in its place. 


A parameter is a character string of up to 31 characters. 
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ATTRIB—Change/Display Disk File Attributes _ 
ATTRIB Eifn:lfilename (attriblist) (@)<er> 
where 


filename is a disk file whose attributes are to be changed. The wild card con- 
struction can be used to-change and/or display the attributes of a group of files. 


attriblist is one or more of the following: 


“lOorll Resets (10) or sets (11) the invisible attribute. 
WO or W1 Resets (WO) or sets (W1) the write-protect attribute. 
FO or F1 Resets (FO) or sets (F1) the format attribute. 
$0 or S1 Resets (SO) or sets (S1) the system attribute. 
Q Specifies query mode operation. 
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Filename—Direct Program Execution 


.C:Fn:lfilename ( parameters] 
where 


parameters. are parameters needed by filename. 


DEBUG—Transfer Control to Monitor 
“DEBUG [CiFn:] filename [parameters]}<cr> 


where 


ae filename is any ISIS-I] command or the file name of an executable program. 


parameters are the normal parameters of the program to be executed. 


_ SUBMIT—Non-Interactive Program Execution 







SUBMIT C:Fn:lfilenamel((parameter(, . . .1)9]<er> 
here 
filename is the name (and extension, if any) of the file containing the command 
sequence definition (explained below). If extension is omitted, SUBMIT 
assumes the default extension .CSD. 
: parameter is an actual value that is to replace a formal parameter in the com- 
mand sequence definition file. The maximum number of parameters allowed is 
10. 1f you omit a parameter from the SUBMIT list, enter a comma in its place. 


A parameter is a character string of up to 31 characters. 
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8086 Program Execution Commands 


RUN—Activate 8086 Execution Mode 


RUN [l:Fnsl filename. {parameters](;comments]]<er > 


eee 


where = 


filename is the name of your 8086 program. If you enter no extension, the 
system assumes a default extension of 86. 


comment is one or more ASCII characters not including a carriage return or line 
feed. Comments always begin with a semicolon. 


a WORK—Change Default Drive for Workfiles 
Pe C[RUN] WORK (:FnzJ<cr> . 
where 
:Fn: specifies the drive n that is to be set as the default drive for your temporary 
workfiles. n is an integer value between 0 and 9 inclusive. The initial system 
default is :F1: If :Fn: is not specified, the current default is displayed. 
DATE—Change/Display System Date 
[RUN] DATE [nn/nn/nn}<cr> 
where 
nn is any integer value between 00 and 99 inclusive that ecifies the date 


desired. If the date is not specified, the last date entered is displayed. The initial 
default date is 09/01/80. 


| EXIT 
EXIT<cer> 









| APPENDIX E 
SUMMARY OF MONITOR COMMANDS 





This appendix provides a summary of the command syntax for Monitor commands. 


Program Execution Commands 


G—Execute Command 


Glstart-addressilbreakpointijl[,breakpointZ]<cr> | 


Monitor 1/O Configuration Commands 


A—Assign Command 
Alogical-device=physical-device <er> 


7 __The possible values of physical-device for each logical-device are: 


Logical Physical Device 
Device ; 


CONSOLE 














T or TTY (teletype terminal) 

C or CRT (compatible CRT terminal) 

B or BATCH (batch mode) 

I (user-defined device for which a user-written program is present) 












READER 





T or TTY (teletype terminal) 
P or PTR (high speed paper tape reader) 

I or 2 (user-defined devices for which user-written driver programs are 
present) 










T or TTY (teletype terminal) 
'P or PTP (high speed paper tape punch) 

1 or 2 (user-defined devices on which user-written driver programs are 
present) - 









| Tor TTY (teletype terminal) 
Cor CRT (compatible CRT terminal) 

Lor LPT (line printer) . 

} (user-defined device for which a user-writien driver program is present) 







-Q—Query Command 


Q<cr> 
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Memory Control Commands 


D—Display Command 


Ostart-address,end-address<cr> 


F—Fill Command 


Fstart~address,end-address,constant<er> 


M—Move Command 


Mstart~-address,end-address,destination-address<cr> 


S—Substitute Command . 
Saddress,(databytel(, (databytell]{[...]<cr> 


X—Register Command (Display Form) 


X<er> 


X—Register Command (Modify Form) 


Xregister, {data] [, data]] [,...]<er> 


Paper Tape 1/0 Commands 


R—Read Command _ 


Rbias<cr> 


Wstart-address,end-address<cr> 


_ E—End-of-File Command 


Eentry-poitnt<cr> . 


_.N—Null Command 


N<er> 
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Utility Command 


H—Hexadecimal Command 


Hnumber? ,number2<cr> 
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SUMMARY OF DEBUG-86 COMMANDS 





This appendix provides a summary of the command syntax of DEBUG-86 
commands. 


Utility Commands 


DEBUG-86 utility commands provide file management capabilities. The utility com- 
mands are: 


EEE: DEBUG—Transfer Control to DEBUG-86 


[:Fnz]RUN DEBUG CL:Fn:] filename (parameters]] 


where 


filename is the name (including extension) of a program that is a valid absolute, 
PIC, or LTL 8086 object module. If no extension is specified, RUN adds an 
extension of .86. If filename ends with a period (as in MYPROG.), the null 
extension is assumed. 


parameters is a series of one or more ASCII] characters (separated by commas or 


spaces) representing variable data required by the user program and to be pro- 
cessed by the program. 


EXIT—Exit DEBUG-86 


ES EX1T<cr> 
LOAD—Load 8086 Object Code 


. ace toe NOSYMBOL 
LOAD (C:Fn:l filename eae |. [cen 


where 


filename is the complete name of a disk file that is a valid absolute, PIC or LTL 
8086 object module. A default extension is not assumed. 


os NOSYMBOL is a modifier that prevents the program symbol table from being 
loaded. 


NOLINE is a modifier that prevents the program line number table (in 
PL/M-86 or PASCAL-86 programs) from being loaded. 
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‘Execution Commands 


GO—Execute 8086 Instructions 


[FOREVER] Fs 
60 LFROM address] { {TILL break-address (OR break-address]] <cp> 
> ETILL break-register (OR break-registerl]] 


where 


FROM address specifies the address of the first instruction to be executed. If 
FROM address is omitted, execution begins at the address in the IP and CS. The 
address must specify the CS:IP content in the form nnnn:nnnn, as in 800:0 
(leading zeros need not be entered). 


: break-address is an integer expression entered as a pointer that references a 20- 
eee bit execution address. 


break-register is one of the breakpoint registers, BRO or BR]. The address for 
BR forms a 20-bit memory address where DEBUG-86 writes a one-byte inter- 
rupt to get control. 


GR Command 

Display form: 
GR<cr> | 

Change form: 


FOREVER 
GR = {TILL break-address [OR break-address] <cr> 
TILL break-register [OR break-register] 


where 


break-address is an integer expression entered as a pointer that references a 20- 
_ bit execution address. The first break-address sets the contents of BRO; the 
second break-address sets the contents of BR]. 


bedrock is one of the breakpoint registers, BRO or BRI (or BR to denote 
both breakpoint registers), that is to be enabled. 


STEP—Execute a Single Instruction 
STEP (FROM addressij<c 1 
where: 
. FROM address specifies the address where single step execution is to begin. If 
FROM address is omitted, the address in the IP and CS is used. The address 


must specify the CS:IP contents in the fog nnnn:nnnn, as in 800: 0 (leading 
2eTOS need not be entered). 
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Change Commands 


Change Register—Change Content of a Register 


register = change-exp<cr> 


bet ie 


where * 
register is one of the following keyword references: 


8086 Register Type Keyword References 


8-bit registers RAL, RAH, RBL, RBH, RCL, 
RCH, RDL, ROH 


16-bit registers RAX, RBX, RCX, RDX, 
ins SP, BP, SI, D1, SS, 
beret ; CS, DS, ES, IP, RF 


1-bit status flags ° CFL, PFL, AFL, ZFL, 
SFL, TFL, IFL, DFL, OFL 


change-exp is a numeric expression specifying the new contents of register. 


Change Memory—Change Contents of Memory Locations 


= change-~exp [,...]19<cr> ~ 


memory-type address j{T0 end-address] 
; CLENGTH a) 


where 


memory-type is one of the following keywords: BYTE, WORD, SINTEGER, 
2 INTEGER, POINTER... 
address is a memory location entered as a pointer value containing a base (which 
can be omitted if 0) and a displacement. If a range is accessed, address is the 
starting address. 


TO end-address specifies the upper limit of a range of memory that is to-be 
modified. The end-address must be greater than or equal to address. Both 
addresses must have the same base. : 


LENGTH n specifies the number of bytes, words, or pointers (depending on 
memory-typeé) to be modified. The value n must be an integer value. ; 


change-exp is the value to replace the contents of the specified memory location. 


Up to 19 change-exps may be listed. The change-exp must be a pointer value if 
memory-type is a pointer; otherwise, it must be an integer value. 
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Change Port—Change Contents of I/O Ports 


{T0 end-address]} 


= =, sree <er> 
[LENGTH nl change exp {,...]19<er 


port-type address 


where 


port-type is one of the following: — oF 


: * PORT—veferences the 8-bit port value at address. 
¢ -WPORT—references the 16-bit port value at address and address + 1, one 
byte at a time and not as a single 16-bit port value. 


address is the address of an 8086 port and is an integer value between 0 through 
65,535 inclusive. If a range of ports is specified, address is the starting address 
of the range. 
TO end-address specifies the upper limit of a range of port addresses. The end- 
address is an integer value between 0 and 65,535 inclusive, and must be greater 
tne than or equal to address. Both addresses must have a base of zero. 
( LENGTH n specifies the number of port or word port addresses to be 
displayed. The value of n must be an integer. 


change-exp is the value to replace the contents of the specified port. 


Display Commands 


Display Register—Display Contents of 8086 Registers 


— 


REGISTER 


registerl, ...J]19 
<cer> 
FLAG 


ete where 


register is any of the following meyword references (up to 19 can be entered, 
separated by spaces): 


8086 Register Type Keyword References 


8-bit registers . RAL, RAH, RBL, RBH, RCL, 
: RCH, ROL, ROH 
16-bit registers. -RAX, RBX, RCX, ROX, SP, 
i, . BP, SI, Di, SS, CS, DS, - 
Be Po sue ES, IP, RF 


1-dit status flags CFL, PFL, AFL, ZFL, SFL, 
; TFL, IFL, DFL, OFL 


REGISTER is a command keyword that causes the ao of all the 16-bit 8086 
registers. 


FLAG is a command keyword that displays all the 1-bit status flags. 
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Display Memory—Display 8086 Memory 


memory-type address (Ene to caeenee)) <er> 


where 


memory-type is one of the following keywords: BYTE, WORD, SINTEGER, 


INTERGER, POINTER. 


address is a pointer value that contains a base (which need not be entered if 0) 
and a displacement and specifies an address of a memory location. If a range is 
specified, address is the starting address in the range. The address can be either: 


TO end-address specifies the upper limi: of a range of memory. The end-address 
must be greater than or equal to address. Both addresses must have the same 
base. 


LENGTH n specifies the number of bytes, words, or pointers to be displayed. 
The value n must be an integer.- 


Display Memory—Display 8086 Memory in ASM Form 


ASK address S[T0 end-address]| <cr> 
° [LENGTH n] 


where 


address is a pointer value that contains a base and a displacement and specifies 
an address of a memory location. If 2 range is specified, address is the starting 
address in the range. The address can be either: 


TO end-address specifies the upper Emit of a range of memory. end-address 
must be greater than or equal to address. Both addresses must have the same 
base. 


LENGTH n specifies the number of bytes, words, or pointers to be displayed. 


' The value of n is an integer. 


Display Port—Display 1/O Port Contents 


port-type address ee eee <er> 


‘ . where 


port-type is one of the following keywords: 
° PORT—references the 8-bit port value at address. 


e WPORT—references the 16-bit pom value at address and address + 1, one 
byte at a time and not as a’single 16-bit port value. _ 


_address is the address of an 8086 por and is an integer value between 0 through 
65,535 inclusive. If a range is specified, address is the starting address of the 
range. 
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TO end-address specifies the upper limit of a range of port addresses. end- 
address is an integer value between 0 and 65,535 inclusive, and must be greater 
than or equal to address. 


LENGTH n specifies the number of port or word port addresses to EE 
displayed. The value n must be an integer. 


ry 


Display Boolean—Display Boolean Value 
BOOL expression<cr> 

where 
expression is an integer expression, the result of which is evaluated to a boolean 
value. If the least significant bit of the result equals 1, the boolean value is 
TRUE; otherwise the boolean value is FALSE. 

Display Stack—Display User Stack Contents 


STACK expression<cr> 


where 


expression is an integer expression, the value of which defines the number of 
words on the user stack to be displayed. 


EVALUATE—Display Integers in Five Bases 
EVALUATE expression [SYMBOLICALLY] <cr> 
where 
‘expression is an ‘iteaer expression. 
SYMBOLICALLY is a keyword that displays each numeric value output by the 
command as as asymbol or a source statement, plus a remainder. 
Symbol Manipulation Commands 
Define Symbol—Enter New Symbol 
DEFINE {..module].symbol = change-exp [OF memory-typel<cr> 
where: 


module is the name of an existing program module, in which symbol is to be 
- located. : 


symbol i is a user-defined symbol to be entered into the symbol table for use dur- 
ing the debugging session. The symbol references a location in the symbol table. 


change-exp is a numeric expression, the value of which is to be assigned to 
symbol. The change-exp represents an address of statement labels or variables, 
or the value of a constant. 


. OF memory-type specifies any of the following: BYTE, WORD, SINTEGER, 
INTEGER, or POINTER. If memory-type is omitted, symbol has no type. 
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Display Symbols—Display One or More Symbols 


; SYMBOL ) 
leheouinie year {.symbol] a Sen? 


where 


SYMBOL causes the entire DEBUG-86 symbol table to be displayed. 


module is the name of the program module in which symbol is located. 


symbol is the name of a symbol that references a location in the symbol table. 


Display Lines—Display Statement Numbers 


a LINE ‘ 
aes eee saa sere 


where. - 


LINE is a command keyword that displays all statement numbers and 
associated absolute addresses in the current domain. 


module is the name of the program module in which stafement-number is 
located. 


statement-number is the source statement number. It is a numeric constant with 
a default suffix that is always decimal. 


Display Modules—Display Module Names 


one , MODULE<cr> 


Change Symbols—Change Value of a Symbol 
. [..modulel.symboll.symbol ...] ... = change-exp [OF memory-typel<cr> 
where . 
module is the name of the program module in which s}mbol is located. 


symbol is the name of an existing symbol that references a location in the sym- 
‘ bol table. 


change-exp is a numeric expression of a pointer value to be assigned to symbol 
a constant. 


OF memory-iype specifies the memory type of symbo/: BYTE, WORD, 
SINTEGER, INTEGER, or POINTER. 


and represents either the address of statement labels or variables, or the value of 
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Remove Symbols Command 
[..module].symbol (.symbol...119 , “| 
<cr> 


REMOVE < SYMBOL 
MODULE ..module [,..module]... 


where é 


module is the name of an existing program module in the symbol table. Up 10 19. 
modules can be listed at one time. 


symbol is the name of an existing symbol in the symbol table. Up to 19 symbols 
can be listed at a time. 


SYMBOL is a command modifier that deletes the entire current DEBUG-86 
symbol table. 


GES MODULE is a command modifier that deletes all the symbols and lines of the 
named module from the symbol and statement number tables. 


Set Domain Command 
DOMAIN ..module<cr> 
. where 


DOMAIN is a command keyword that establishes a default module for source 
statement number references. eee ee ieee sebvibet 


module is the name of an existing program module in the statement number 
° table and is prefixed by two periods a 


Compound Commands 
: REPEAT Command 


REPEAT<cr> 
command<er> : 
WHILE boolean- nexpressioncer> | ee 
UNTIL boolean-expression<cr> 
END<cr> 
COUNT Command 
° COUNT arithmetic-expression<cr> 
conmmand<cr> 
WHILE boolean~-expression<cr> eas 


UNTIL boolean- expression<cr> 
END<cr> 
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IF Command 
IF boolean-expression [THEN] <cr> 
leommand<cr>] ... 


ORIF boolean-expression [THEN] <cr 
[command<cr>] ... 


ELSE<cr> ] 
{command<cr>] ... 


END<cr> 


povene 
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Summary of Error Messages 


feces 


When error 24 occurs, an additional message is displayed: 


NOTE 


STATUS=00nn 


D=x T= 


yyy $=222z 
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where x represents the drive number, yyy the track address, zzz the sectar 


address, and where nn has the following meanings: 


For flexible disks: 

01 Deleted record 

02. ~=« Data field CRC error 
.03 Invalid address mark 

04 Seek error 

08 #$Address error 

QA 10 field CRC error 

0E Noaddress mark 

OF ‘Incorrect data address mark 

10 Data overrun or data underrun 
20 = Attempt to write on Write Protect 
40  Orive has indicated a Write error 
80 Drive not ready 

For hard disks: 

01 1D field miscompare 

02. Data fieid CRC error 

04 Seek error 

08 Bad sector address 

OA 1D field CRC error 

08 Protocol violations 

OC Bad track address 

OE Noid address mark or sector not found 
OF Sad data field address mark 

40 Format error 

20 = Attempt to write on write-protected drive 
40  ODrive has indicated a write error 
80 =—Drive not ready 


RUN Program Error Messages (8086 Execution Mode) 


101. HARDWARE NOT RESPON DING (fatal error) 


- 102. INVALID SYNTAX 


103. COMMAND LINE TOO LONG : 
104. INSUFFICIENT MEMORY TO LOAD 

108. MISMATCHED SOFTWARE/ FIRMWARE 
106. ILLEGAL LOAD ADDRESS 

107. ILLEGAL LOAD ADDRESS 


“408. INVALID OBJECT FILE 


117. UNRESOLVED SYMBOLS (warning) 
118. RAM FAILURE (warning) 
119. ROM CHECKSUM ERROR (warning) 


DEBUG-86 Error Messages (8086 Execution Mode) 


120. Syntax error 
121. Invalid token 
122. No such line 
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123. Inappropriate number 
124, Partition bounds error 
125. Symbol already exists 
126. Symbol does not exist 
127. Memory failure 
133. Null string error 
134. Memory overflow 
138. Stack overflow 
- 136. Command too complex 
137. Module does not exist 
ar 139. Excessive data 
141. Unsuitable execute file 
142. Line too long 
143. Too many partitions 
147. Pointer value required 
- 148. Integer value required 
149. Differing bases 


9 the 
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Console Command Interface Errors (8080/8085 
Execution Mode) 


201. Unrecognized swiich 

202. Unrecognized delimiter 

203. invalid syntax 

206. illegal disk labe! 

208. Checksum error 

209. Relo file sequence error 

210. insufficient memory 

211. Record too long 

212. illegal relo type 

213. Fixup bounds error 

i 214. Illegal SUBMIT parameter 

215. Argument too long : 

216. Too many parameters 

217. Object record too shor 

218. illegal record format 

” 219. Phase error 

: 220. No EOF record in object module file 
221. Segment overflow during LINK operation 
222. Unrecognized record in object module file 
223. Fixup record pointer is incorrect 
224. Wegal record sequence in object module file in LINK. . 
225. illegal module name specified 
226. Module name exceeds 31 characters. 
227. Command syntax requires left parenthesis 
228. Command syntax requires right parenthesis 

-» 229. Unrecognized control specified incommand 
230. Duplicate symbol found 
231. File already exists 
232. Unrecognized command 
233. Command syntax requires a TO clause 
234. Filename illegally duplicated in command 

_ 235, File specified in command is nota library file 

236. More than 249 common segments in input files 
237. Specified common segment not found in object file 
238. Illegal stack content record in object file 
239. No module header in input object file 
240. Program exceeds 64k bytes 
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8080/8085 execution mode, 1-3, 4-29 
8086 execution mode, 1-3, 4-34 
> (angle bracket) 
_ RUN prompt, 4-35 
.& (ampersand) . 
continuation lines, 4-35, 6-3 
® (asterisk) 
DEBUG-86 prompt, 6-1 
wild card character, 4-17 
# (pound sign) 
line-editing, 3-6 
‘Monitor, 5-4 


“iid card character, 4-17 
=(. shen) 
JS1S-H1 prompt, 4-2 


_ Acommand, 5-8 
A switch (FORMAT), 4-7 
aborting commands, 1-6, 3-7 
accessing - 
devices, 3-1 
files, 3-1 
ACTIVE indicator, 2-7 
AND operator, 6-14 
appending files, 4-20 
arithmetic 
expressions, 6-4 
operators, 6-10 
rules, 6-15 - 
arrow keys, 1-5 
ASwi ‘form, 6-34 
A n(A) command, 5-8 
Ajy1iRIB command, 4-28 
attributes, 3-4 


‘B switch (COPY), 4-20 
BACKUP switch (HDCOPY), 4-23 
basic disk. 
non-system disk, 4-3 
system disk, 4-3 
‘basic system, 1-2 
BATCH, 5-8 
BB:, 3-2 
binary operators, 6-12 - 
blocks, 3-4 . 
boolean expressions, 6-37 
breakpoints . 
DEBUG-86, 6-22 
Monitor, 5-5 
BR, 6-22 
“brush indicator, 2-7 
BYTE, 6-6 
byte bucket, 3-2 


C switch (COPY), 4-20 
calls, system, 3-1 
care of disks 
flexible disks, 2-1 
hard disks, 2-7 
carriage return key, 1-5 
cartridge holddown arms, 2-7 
CB), 2-7 
Change Memory command, 6-27 
Change Port command, 6-30 
Change Register command, 6-26 
Change Symbols command, 6-46 
checksum errors (Monitor), 5-5 


CNTL key, 1-5 
CNTL-C, 3-8 


:CO:, 3-2 yea 
code conversion commands, 4-2 
comment lines 
DEBUG-86, 6-3 
ISIS-Il 
8080/8085 mode, 4-2 
8086 mode, 4-35 


concatenation, 4-20 
compound commands, 6-48 


COUNT command, 6-50 
_ IF command, 6-51 

nesting of, 6-52 

REPEAT command, 6-48 
configurations, drives, 1-8 
console commands, 

see 1SIS-II console commands .- 
console device, 3-2, 5-8 
console, system, 3-6 
content operator, 6-13 
continuation lines, 6-3 
control characters, 1-3 

CNTL-C, 3-8 

CNTL-D, 3-8 

CNTL-E, 4-32 

CNTL-P, 3-6 

CNTL-Q, 3-7 

CNTL-R, 3-6 

CNTL-S, 3-7 

CNTL-X, 3-6 

CNTL-Z, 3-6 
control panel, 1-6 


_ converting 


absolute object code to hexadecimal, 4-2 
decimal to hexadecimal, B-} 
hexadecimal to absolute object code, 4-2 
hexadecimal to decimal, B-1 
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Index 


COPY command, 4-20 
copying a disk file, 4-20 
hard disk, 4-20, 4-23 
COUNT command 
DEBUG-86, 6-50 
FIXMAP, 4-13 
creating and managing files, 3-1 
CREDIT text editor, 4-2 
CRT terminal, 1-4 
CS file (SUBMIT), 4-32 
CSD file (SUBMIT), 4-32 
cursor, 1-4 


D command, 5-10 
DATE command, 4-37 
DEBUG command 
—_ DEBUG-86, 6-17 
E Monitor, 4-30 
PBUG-86, 6-1 
» .~BUG-86 commands 
Change commands 
Memory, 6-27 
Port, 6-30 
Register, 6-26 
Symbols, 6-46 
COUNT command, 6-50 
DEBUG command, 6-17 
Define symbol command, 6~40 
Display commands 
Boolean, 6-37 
Lines, 6-43 
Memory, 6-32 
Memory (ASM form), 6-34 
Modules, 6-44 
* Port, 6-36 
Registers, 6-31 
Stack, 6-38 
Symbols, 6-42 


( “O command, 6-21 
~GO Register command, 6-24 
GR command, 6-24 
IF command, 6-51 
LOAD command, 6-20 
Remove Symbols command, 6-46 
REPEAT command, 6-48 
Set Domain command, 6-47 
STEP command, 6-24 
debugging programs 
DEBUG-86, 6-1 
Monitor, 4-1 
- decimal-to-hexadecimal conversions, B-1 
-Define Symbol command, 6~40 
‘DELETE command, nee 
deleting 
characters, 1-5, 3-6 
file from directory, 4-26 
sdevice:,3-1 
device/file accessing, 3-1. 
device names, 3-1 
directory 
contents, 3-4 
listing, 4-18 
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DIR command, 4-18 
disk drive units, 1-7 
disk insertion (flexible disk), 2-2 
disk installation (hard disk), 2- 10 
disk removal 
flexible disk, 2-2 
hard disk cartridge, a 
disks 
addressing, 3-2 
back-up, 2-5 
care of, 2-1, 2-7 
directory, 3-4, 4-18 
drives, 1-7 
flexible, 1-8 
formatting, 2-5, 4-3 
hard disk, 
non-system, 1-9 
fangs characteristics, 1-8 
system, 1-9 
types, 1-9 
display, 1-4 \ 
Display (D) command, 5-10 
Display Boolean command, 6-37 
Display Lines command, 6-43 
Display Memory (ASM form), 6-34 
Display Memory command, 6-32 
Display Modules command, 6-44 
Display Port command, 6-36 
Display Register command, 6-31 
Display Stack command, 6-38 
Display Symbols command, 642 
DOMAIN, 6-47 ; 
double density disks, 1-8 
DQSGETSARGUMENT, 6-3 
drive configurations, 1-8 
drive units, 1-7 


E command, 5-16 
editing 
characters, 3-6 
files, 4-2 
lines, 3-6 
END clause, 6-48 
End-of-File command, 5-16 
error messages, 7-] 
console command interface, 7-8 
DEBUG-86, 7-7 
ISIS-H1, 7-3 
RUN, 7-6 
ESC key, 1-5 
Evaluate command, 6-38 
Execute (G) command, 5-5 . 
execuling programs 
8080/8085 programs, 4-30 
8086 programs, 4-34 
execution modes, 1-2 
EXIT commands 
DEBUG-86, 6-19 
FIXMAP, 4-15 
RUN, 4-34 
expressions, 6-4 
extensions, 3-3 
external disk drive units, 1-7 


F attribute, 3-5, 4-28 
F command, 5-11 
F switch, 4-18 
FO (ATTRIB), 4-29 
Fi (ATTRIB), 4-29 
fatal errors, 7-1 
FAULT 
operation, 2-12 
switch/indicator, 2-7 
filenames (program execution) 
8080/8085 mode, 4-30 
8086 mode, 4-34 
filenames, 3-2 
files 
accessing, 3-1 
characteristics, 1-8 
copying, 4-20 
creating and editing, 4-2 
gsieletion, 4-26 
“CHxeCUUNg, 1-3, 4-30 
* “tensions, 3-3 
name format, 3-2 
_ names, wild card, 4-17 
types, 1-9 
Fill (F) command, 5-11 
FIXMAP command, 4-9 
Count command, 4-13 
Free command, 4-11 
List command, 4-12 
Mark command, 4-10 
Quit command, 4-14 
Record command, 4-14 
__ flexible disk, 1-8 
care of, 2-1 
formatting of, 2-5 
insertion, 2-2 
removal, 2-2 
FLAG, 6-31 
:Fn:, 3-3 
eta 6-21, 6-23 






¥*"mnat files, 3-5, 4-4 
. JRMAT command, 2-3, 4-4, 4-7 
Formatting of disks 

Back-up disk, 2-5 

Flexible disk, 2-5 

FORMAT, 4-7 

Hard disk, 2-9, 4-5, 4-7, 4-23 

HDCOPY, 4-23 

IDISK, 4-5 

non-system disk, 2-5 

single drive system, 2-6 
Free command (FIXMAP), 4-11 
front panel, 1-6 : 





G command, 5-5 
Gocommand, 6-21 

Go Register command, 6-23 
GR command, 6-23 


H command, 5-17 

hard disk cartridge 
care of, 2-7 
cartridge, 1-9 
installation, 2- 11 
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removal, 2-11 
hard disk system 
controls, 2-7 
power-down, 2-12 - 
start-up, cold, 2-9 
Start-up, subsequent, 2-13 
HDCOPY command, 4:23 
hexadecimal 
command, $-17 
paper tape format, A-1 
to decimal conversion, B-1] 
HOME key, 1-5 
:HP:, 3-2 
*HR:, 3-2 


L attribute, 3-5, 4-28 
I switch (DIR), 4-18 
10 (ATTRIB), 4-27 
1] (ATTRIB), 4-27 
eI1:, 3-2 
IDISK command, 2-4, 4-3, 4-5 
IF command, 6-51 
initial system console, 3-6 
initiation of 
disks, see FORMAT, 4-7 
disks, see IDISK, 4-5 
system, see Monitor, 5-1 
INTEGER, 6-6 
integers, 6-4 
integrated disk drive, I-1 
Intellec terminal, 1-4 
interactive mode 
DEBUG-&6, 6-18 
loading programs, 6-18 
RUN, 4-34 : 
interfaces, peripherals, 1-1 
interrupt switches, 1-6 
interrupting program execution 
8080/8085 mode, 3-7 
8086 mode, 3-8 ; 
DEBUG-86, 6-4 
invisible (1) attribute, 3-5,.4-28 _ 
1/O interface, 1-1, 4-1 
1/0 Ports, 6-29 
ISIS-II console commands 
ATTRIB, 4-28 
COPY, 4-20 
‘ DEBUG (Monitor), 4-30 
DELETE, 4-26 
DIR, 4-18 
filename, 4-30 
FIXMAP, 4-9 
FORMAT, 4-7 
HDCOPY, 4-23 | 
IDISK, 4-5 
RENAME, 4-27 
RUN, 4-34 
SUBMIT, 4-31 


keyboard, 1-5 
keyword references, 6-4 


“Ls, 3-2 


_ Librarian, 4-2 


Linker, 4-2 


Index-3 


Index 


LINE, 6-43 

line editing, 3-6 _ 

line feed, 1-5 

line terminators, intermediate, 6-3 
lines, display of, 6-14 

List command (FIXMAP), 4-12 
list device, 5-8 

LOAD command, 6-20 
‘Locator, 4-2 

logical device names, 3-1 

logical operators, 6-14 

Jooping commands, 6-48 

tLP:, 3-2 


M command, 5-11 
main.circuit breaker, 2-7 
Mark command (FIXMAP), 4-10 
memory (8086) 
4 ee form, 6-34 
o ay contents of, 6-32 
k., words, 6-6 
references, 6-6 
types, 6-7 
memory control commands 
(8080/8085), 5-9 
messages, error, 7-1 
MOD (modulo reduction), 6-11 
MODULE, 6-44, 6-46 
module references, 6-9 
modules, display of, 6-44 
Monitor, 5-1 
Monitor commands 
Acommand, 5-8 
Assign command, 5-8 
’ Dcommand, 5-10 
Display command, 5-10 
E command, 5-16 
End-of-File command, 5-16 
Execute command, 5-5 
&ommand, 5-11 
F" command, 5-11 
\ -ommand, 5-5 
H command, 5-17 
Hexadecimal command, 5-17 
M command, 5-11 
Move command, 5-11 
N command, 5-17 
Null command, 5-17 
Q command, 5-9 
Query command, 5-9 
R command, 5-15 + 
Read command, 5-15 
Register command, 5-13 
S command, 5-12 
Substitute command, 5-12 
W command, 5-16 
‘Write command, 5-16 
X command, 5-13 
"Move (Mj) command, 5-11 








N command, 5-17 

N switch (COPY), 4-20 

Nesting compound commands, 6- 52. 
NOLINE, 6-20 
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non-fatal errors, 7-1 
noninteractive mode 
DEBUG-86, 6-17 
Loading programs, 6-18 
RUN, 4-35 ; 
SUBMIT, 4-31 
NOSYMBOL, 6-20 . 
NOT operator, 6-14 = 
Notational conventions, iii 
Null command, 5-17 
Numeric constants, 6-5 


:01:, 3-2 
O switch (DIR), 4-18 
Operator-controlled pauses, 3-7 
operators 

arithmeric, 6-10 

content, 6-13 

logical, 6-14 

relational, 6-12 
OR operator, 6-14 


P switch 

COPY, 4-20 

DELETE, 4-26 

DIR, 4-19 

Pes 4-5 

2, 3-2. 

Soe tape punch, 5-7 
parameters, formal, 4-32 
pathnames, 3-1 
peripherals, 1-4, 4-1 
POINTER, 6-6 
pointers, 6-4 
ports (8086) 

change contents, 6-29 

display contents, 6-31 
POWER ON switch, 1-6 
prompt characters, 1-4 
PUNCH, 5-7 


Q command, 5-9 
Q switch 
ATTRIB, 4-28 
COPY, 4-20 
DELETE, 4-26 
Query (Q) command, 5-9 
Query mode % 
ATTRIB, 4-28  — \ 
COPY, 4-20 \ 
DELETE, 4-26 \ 
Quit command (FIXMAP), 4- 14 


R command, 5-15 se PN 
tRis, 3-2 ‘ 
:R2:, 3-2 
Read (R) command, 5-15 
READER, 5-8 
READY indicator, 2-7 
Record command (FIXMAP), 4-14 
REGISTER, 6-31 
Register (X) command, 5-15 
register keywords, 6-7 
registers (8086) 

‘ change contents, 6-26 


